Boardsesh Climbing Logbook MCP server

boardsesh-mcp

<!-- mcp-name: io.github.wmmg101/boardsesh-mcp -->

An unofficial MCP server that lets your AI agent read and analyse your Boardsesh climbing logbook — across every board you climb on: Kilter, Tension, MoonBoard, Decoy, Touchstone, So iLL, Woods and spray walls.

How did my last session go?

Am I stronger on Kilter or on Tension?

What are my projects at 40°?

What should I try next at my level?

Show my grade pyramid. Which holds do I avoid?

Read-only. Nothing is ever written to your Boardsesh account.

You do not need to give it a password. Boardsesh serves your logbook publicly, so your display name alone unlocks most of it. Credentials are optional and only add the extras.

Add to your agent

Kiro

Open your MCP config (command palette → Kiro: Open user MCP config (JSON)) and add:

{
  "mcpServers": {
    "boardsesh": {
      "command": "uvx",
      "args": ["boardsesh-mcp"],
      "env": {
        "BOARDSESH_USER": "Your Boardsesh Display Name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

That is the whole setup. BOARDSESH_USER is the display name on your Boardsesh profile (or your user id, if you prefer). Requires uv installed; uvx ships with it.

Other clients

Same three facts everywhere: command uvx, args ["boardsesh-mcp"], env BOARDSESH_USER. Copy-paste configs for Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI and Zed are in docs/clients.md.

Optional: unlock the rest

Four tools need to know which physical board setup you use (layout, size, hold sets), which Boardsesh only tells the logged-in owner. Add your Boardsesh login to enable them:

"env": {
  "BOARDSESH_USER": "Your Display Name",
  "BOARDSESH_EMAIL": "${BOARDSESH_EMAIL}",
  "BOARDSESH_PASSWORD": "${BOARDSESH_PASSWORD}"
}

Those four are boardseshrecommendclimbs, boardseshsearchclimbs, boardseshfindsimilarclimbs and boardseshgetholdheatmap. Everything else works without them. See how to set environment variables.

Optional: timezone

Sessions are grouped by calendar day in your timezone, detected from the machine running the server. If that is wrong, add "BOARDSESH_TIMEZONE": "Europe/Rome" (any IANA name).

Example questions

Summarise my Boardsesh logbook.
How did my last session go?
Compare my climbing on Kilter and Tension — where am I actually stronger?
What are my current projects, and which have I tried the most?
Show my grade pyramid and my flash rate per grade.
Have I improved over the last six months?
What should I try next at my level?
Find climbs similar to the one I sent yesterday.
Which holds show up most in climbs one grade above me?

Tools the agent gets

Works with just BOARDSESH_USER:

Needs BOARDSESHEMAIL / BOARDSESHPASSWORD:

Shortened. The full README is on GitHub.