Skip to main content
Glama
kilter-mcp

kilter-mcp

kilter-mcp

An unofficial MCP server that lets your AI agent read and analyse your own Kilter Board logbook.

Add it to Kiro (or another MCP client), give it your Kilter login, and then just talk to the agent:

How did my last Kilter session go? What are my current projects at 30°? Compare my climbing at 20° and 40°. Show my grade pyramid. What are my hardest sends? Am I progressing?

Read-only. Nothing is written to your Kilter account.

Add to Kiro + Other Clients (Claude, Codex, Cursor etc.)

Add to Kiro

Click the button (Kiro shows a confirmation dialog first), then jump to step 3. Or do it by hand:

  1. Open your MCP config in Kiro: command palette → Kiro: Open user MCP config (JSON) (or the workspace one, .kiro/settings/mcp.json).

  2. Add the server:

{
  "mcpServers": {
    "kilter": {
      "command": "uvx",
      "args": ["kilter-mcp"],
      "env": {
        "KILTER_USERNAME": "${KILTER_USERNAME}",
        "KILTER_PASSWORD": "${KILTER_PASSWORD}"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  1. Provide your Kilter credentials. Either:

    • set KILTER_USERNAME and KILTER_PASSWORD as environment variables (Kiro expands ${VAR} after you approve the variables in Settings → Mcp Approved Env Vars; see how to set them on macOS, Linux and Windows), or

    • replace the ${...} placeholders with the literal values. Only do this in the user config (~/.kiro/settings/mcp.json), never in a workspace config you might commit.

  2. Save. Kiro starts the server and the kilter_* tools appear. Ask away.

Something not working? With the same variables exported in a terminal, run uvx kilter-mcp --check. It logs in, counts your logbook and prints a short report with no secrets or entries in it, which you can paste into an issue.

Requirements: uv installed (uvx comes with it). Python is handled by uv.

Kiro CLI users can do the same with kiro-cli mcp add --name kilter --scope global --command uvx --args kilter-mcp --env KILTER_USERNAME=... --env KILTER_PASSWORD=....

Optional: timezone

Sessions are grouped by calendar day in your timezone, which is detected from the machine running the server. If that is wrong (for example a remote or containerised host), add "KILTER_TIMEZONE": "Europe/Rome" (any IANA name) to the env block. Every response states the timezone it used.

Other clients

kilter-mcp is a standard local MCP server, so it also works in Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI and Zed. Copy-paste configs for each are in docs/clients.md. (ChatGPT's chat interface only accepts remote HTTP servers, so it is not supported directly; details in the same document.)

Related MCP server: strava-mcp

Example questions

Show my latest Kilter session.
What did I climb last Saturday?
List my sends from this month at 40°.
What are my current projects?
Which projects have I put the most attempts into?
Show my grade pyramid at 30°.
What is my flash rate per grade?
What are my five hardest sends?
Compare my climbing at 20° and 30°.
How has my climbing progressed over the last six months?

Tools the agent gets

Tool

What it returns

kilter_get_logs

Logbook entries (filter by limit, angle, topped, date range)

kilter_get_sends

Topped climbs, newest first

kilter_get_projects

Climbs attempted but never topped at that angle

kilter_get_summary

Totals, angles, date range, hardest send/flash, sends by grade

kilter_get_grade_pyramid

Sends per grade with flash rates

kilter_get_hardest_sends

Hardest unique sends

kilter_get_sessions

Entries grouped by day

kilter_get_progression

Month-by-month or week-by-week trend

kilter_get_angle_stats

Per-angle comparison

All tools are read-only and only ever see the account whose credentials you configured.

How the data is interpreted

  • One logbook entry is one climb at one wall angle on one date, with the number of tries in that entry. Re-logging a climb creates a new entry.

  • status is flash (topped first try), send (topped) or attempt (not topped).

  • A project is a (climb, angle) pair with attempts but no top at that angle.

  • Grades are Kilter's current consensus grade for the climb at that angle. grade is the V-scale and font_grade the Font scale; the raw difficulty_id (1-39) is always included. The grade table is fetched from Kilter at startup with an embedded fallback.

  • If you rated a climb yourself in the app, my_grade and my_rating (1-5 stars) carry your opinion; otherwise they are null.

  • Dates are reported in your timezone (see above). A session is one calendar day.

Security and privacy

  • Your username and password are only used to obtain an OAuth token from Kilter's login server (idp.kiltergrips.com). They never leave your machine otherwise.

  • Tokens are kept in memory for the life of the MCP process and are never written to disk.

  • Credentials and tokens are never included in tool output, logs or error messages.

  • The server makes requests only to idp.kiltergrips.com and portal.kiltergrips.com.

  • Also available in the MCP Registry as io.github.wmmg101/kilter-mcp.

  • Prefer the ${KILTER_PASSWORD} form so the password lives in your shell environment or secret manager rather than in a JSON file.

  • Your logbook is fetched at most once a minute, however many tools the agent calls, and Kilter's rate-limit responses are respected.

Full details and how to report a problem privately: SECURITY.md.

Disclaimer

kilter-mcp is an unofficial community project and is not affiliated with or endorsed by Kilter Grips. It talks to the same endpoints the Kilter app uses; these are not a documented public API and may change or stop working at any time. Kilter's Terms of Use restrict access to their services outside the official apps; use this project at your own discretion, only with your own account, and keep request volume low (the server fetches your logbook once per tool call).

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for the development setup (git clone, uv sync, uv run pytest), architecture notes, and how to add a tool.

License

MIT

Available Tools

9 tools
kilter_get_angle_statsA
Read-only

Return per-wall-angle statistics so angles can be compared.

Use when the user asks to compare angles (e.g. 20° vs 40°), which angle they climb hardest or most at, or flash rate by angle. One row per angle with sends, flashes, attempts, sessions, hardest send/flash and sends per grade.

Inputs: no named parameters. Returns: object

kilter_get_grade_pyramidA
Read-only

Return the user's send pyramid: sends per grade, hardest first, with flash rates.

Use when the user asks about their grade pyramid, distribution of grades, flash rate per grade, or how solid they are at a level. Optional wall-angle filter.

Inputs: angle. Returns: object

kilter_get_hardest_sendsA
Read-only

Return the user's hardest sent climbs (unique per climb and angle), hardest first.

Use when the user asks about their hardest sends, best climbs, max grade, or personal bests. Optional wall-angle filter; limit defaults to 10.

Inputs: angle, limit. Returns: object

kilter_get_logsA
Read-only

Return the user's Kilter logbook entries, newest first.

Use when the user asks about recent Kilter climbs, attempts, what they climbed on a date, or wants raw history. Each entry is one climb at one wall angle on one date with the number of tries in that entry. Filters: limit (default 25, max 500), angle (degrees), topped (true=only sends, false=only unsuccessful attempts), start_date/end_date (YYYY-MM-DD, inclusive).

Inputs: angle, limit, topped, end_date, +1 more. Returns: object

kilter_get_progressionA
Read-only

Return climbing progression over time, oldest period first.

Use when the user asks how they have progressed, trends, whether they are improving, or for a month-by-month/week-by-week view. period is 'month' (default) or 'week'. Each period has sessions, sends, unique climbs, flashes, attempts and hardest send/flash. Optional wall-angle filter.

Inputs: angle, period. Returns: object

kilter_get_projectsA
Read-only

Return the user's projects: climbs attempted but never topped at that wall angle.

Use when the user asks what they are working on, unfinished climbs, or what to try next. A climb is a project per (climb, angle); sending it at another angle does not remove it. Sorted by most recently tried, then most attempts. Optional angle filter.

Inputs: angle, limit. Returns: object

kilter_get_sendsA
Read-only

Return climbs the user has topped (sent), newest first.

Use when the user asks about their sends, ticks, completed climbs or flashes. Entries with status 'flash' were topped on the first try. Filters: limit (default 25, max 500), angle (degrees), start_date/end_date (YYYY-MM-DD).

Inputs: angle, limit, end_date, start_date. Returns: object

kilter_get_sessionsA
Read-only

Return recent climbing sessions (entries grouped by calendar day), newest first.

Use when the user asks how their last session went, what they climbed yesterday, or wants to compare sessions. Each session lists angles, sends, flashes, attempts, hardest send and every climb logged that day. limit defaults to 5.

Inputs: limit. Returns: object

kilter_get_summaryA
Read-only

Return a compact overview of the user's whole Kilter history.

Use first when the user asks a broad question ("how is my climbing going?", "summarise my Kilter account") or when you need totals: entries, sends, flashes, attempts, angles climbed, date range, session count, hardest send/flash and sends per grade.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 9 tools

    Disambiguation4/5

    Each tool targets a distinct analytical view (sends vs logs vs projects vs sessions), but sends, logs, and hardest_sends overlap in the 'climbed successfully' space. Descriptions clarify the differences well, so confusion is unlikely but possible for an agent searching for a send list.

    Naming Consistency5/5

    All tools follow the exact same kilter_get_<noun> pattern, making the naming scheme highly predictable and easy to navigate. No mixed conventions or verb variations exist.

    Tool Count5/5

    Nine tools is well within the ideal range for a focused analytics server. Each tool covers a distinct query mode without unnecessary bloat or obvious redundancy.

    Completeness4/5

    The tool surface covers the key analytical queries for a Kilter climbing history: overall summary, per-angle stats, progression, sessions, projects, sends, and hardest sends. Minor gaps exist such as no per-climb detail view or direct grade-based filtering of send lists, but these are workable via existing tools.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers