Runspector — AI running coach and Garmin MCP server

A local-first AI running coach for your Garmin data. Runspector syncs your Garmin Connect data into a SQLite file on your own machine, decides today's training (GO / EASY / REST) with a deterministic readiness engine, and lets Claude explain that decision and plan the week with you: in a small web app, or as an MCP server for Claude Code and Claude Desktop. Nothing reaches your watch without your yes.

Formerly runcoach-ai. Source, full documentation and the design decisions: github.com/edxleon/runspector.

Quick start

uv tool install runspector    # needs uv: https://docs.astral.sh/uv/
# without uv:                 pipx install runspector
runspector serve --demo       # look around without any account
runspector serve              # the real thing: opens http://127.0.0.1:8765, sign in to Garmin there

Coach cards run on Claude Code on your machine, with your own Claude sign-in: install it and run claude auth login once. It needs a paid Claude plan (Pro, Max, Team or Enterprise) or an Anthropic API account; no API key is needed on a plan. Without Claude Code, coach in the Claude Desktop chat instead (below). Everything except the coach works without Claude. Step by step: Connecting Claude.

In Claude Code or Claude Desktop

claude mcp add runspector -- runspector mcp
# then ask: "should I train today?"

Or, without installing it first, in an MCP client's JSON configuration:

{ "mcpServers": { "runspector": { "command": "uvx", "args": ["runspector", "mcp"] } } }

Sign in to Garmin once before that: runspector login (or uvx runspector login).

Good to know

• Your Garmin password goes to Garmin once, to sign in; only the session token is kept, in a folder only your user account can read.
• Not affiliated with Garmin. It uses the unofficial python-garminconnect library against your own account.
• A training tool, not medical advice.

MIT licensed. Issues: github.com/edxleon/runspector/issues.