Run Coach — Claude Code MCP server: setup
Connects Garmin data to an AI client for health views, workout analysis, trends, and weekly planning. Sign-in is needed on first use.
claude mcp add garmin-mcp-app -- npx -y garmin-mcp-appWhat Run Coach does
Run Coach connects Garmin Connect to Claude Code through MCP. The client can read sleep, HRV, heart rate, training load, VO2 Max, readiness, and activity data. It can render interactive charts, compare measurements with personal baselines, and inspect runs through per-kilometre splits, heart-rate zones, and training effect.
The server can build a training week, create workouts, and schedule them on the Garmin calendar. You sign in to Garmin on first use. Node.js 20+ is required for the Claude Code setup, so the server will not start without it. MCP Apps clients can show the sign-in form and charts; other clients receive the Garmin tool data without that embedded form.
What it helps with
- compare Garmin metrics with personal baselines
- inspect a run through splits and heart-rate zones
- build a training week from Garmin data
- create and schedule workouts on the Garmin calendar
- track sleep, HRV, and training-load changes
Example prompts for the agent
- Show how my fitness has changed over the last 4 weeks.
- Break down my latest run by kilometre splits and heart-rate zones.
- Create a training plan for this week from my Garmin data and schedule it on my calendar.
How to install Run Coach
Platform CLI
claude mcp add garmin-mcp-app -- npx -y garmin-mcp-appPlatform CLI
codex mcp add run-coach -- npx -y garmin-mcp-appConfig file
{
"mcpServers": {
"run-coach": {
"command": "npx",
"args": [
"-y",
"garmin-mcp-app"
]
}
}
}Config file
{
"servers": {
"run-coach": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"garmin-mcp-app"
]
}
}
}Platform CLI
gemini mcp add run-coach npx -y garmin-mcp-appStep 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 Run Coach
How do I install Run Coach in Claude Code?
Install Node.js 20+, then run claude mcp add garmin-mcp-app -- npx -y garmin-mcp-app. The server will ask you to sign in to Garmin when you use it for the first time.
What does Run Coach do?
It gives an AI client access to Garmin data, creates interactive charts, and supports health, fitness, and workout analysis. It can also create and schedule Garmin workouts.
Which Garmin data does Run Coach support?
It covers sleep, heart rate, HRV, body battery, activities, training load, VO2 Max, race predictions, devices, gear, and workout scheduling.
