Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add runspector -- uvx runspector
Open on GitHub

What 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 runspector

uvx 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.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open