Runspector — Claude Code MCP server: features and setup
Runspector — AI running coach for Garmin is an MCP server for Claude Code that connects Garmin data to an AI running coach. It explains readiness and VO2max and helps plan training.
MIT ★ 11 updated 2026-11-15
claude mcp add runspector -- uvx runspectorWhat Runspector — AI running coach for Garmin does
Runspector syncs Garmin Connect data to a local computer and makes it available to an AI coach. The coach interprets readiness, HRV and VO2max, chooses between a hard session, an easy run or rest, and helps shape a weekly plan. The project also describes workouts delivered to Garmin watches.
Data stays in a local SQLite file, and a small web app can display it. A Garmin account is needed, and syncing uses the unofficial python-garminconnect library. The server starts with uvx runspector, which requires uv.
What it helps with
- interpret Garmin readiness data
- understand VO2max changes
- choose between a hard session, an easy run and rest
- plan a week of running
Example prompts for the agent
- Explain my Garmin data and assess my training readiness.
- Plan a running week using my VO2max data.
- Should today be a hard workout, an easy run or a rest day?
How to install Runspector — AI running coach for Garmin
Platform CLI
claude mcp add runspector -- uvx runspectoruvx runs the command named after the package; if the README names another one, use uvx --from runspector <command>
Platform CLI
codex mcp add runspector-ai-running-coach-for-garmin -- uvx runspectoruvx runs the command named after the package; if the README names another one, use uvx --from runspector <command>
Config file
{
"mcpServers": {
"runspector-ai-running-coach-for-garmin": {
"command": "uvx",
"args": [
"runspector"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from runspector <command>
Config file
{
"servers": {
"runspector-ai-running-coach-for-garmin": {
"type": "stdio",
"command": "uvx",
"args": [
"runspector"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from runspector <command>
Platform CLI
gemini mcp add runspector-ai-running-coach-for-garmin uvx runspectoruvx runs the command named after the package; if the README names another one, use uvx --from runspector <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Runspector — AI running coach for Garmin
How do I install Runspector — AI running coach for Garmin in Claude Code?
Add the server with claude mcp add runspector -- uvx runspector. An alternative server name is claude mcp add runspector-ai-running-coach-for-garmin -- uvx runspector.
What does Runspector — AI running coach for Garmin do?
It gives an AI coach access to Garmin data so it can explain readiness and VO2max, choose a training intensity, and help plan the week.
What does Runspector — AI running coach for Garmin need to run?
It needs a Garmin account and uv, which provides the uvx command. Syncing uses the python-garminconnect library.