Run Coach

Run Coach — Garmin MCP App

Connect your Garmin watch to Claude Desktop or ChatGPT. Explore interactive charts.

_{Unofficial. Not affiliated with or endorsed by Garmin. Garmin is a trademark of Garmin Ltd.}

[demo]

Install

Claude Desktop

1. Download the latest .mcpb file from Releases
2. Drag it into Claude Desktop to install
3. Ask Claude anything about your Garmin data — it will prompt you to sign in on first use

ChatGPT (desktop app)

Requires Node.js 20+.

1. In the ChatGPT desktop app, open Settings → Plugins → Add marketplace
2. Source: chenhunghan/garmin-mcp-app (leave Git ref and sparse paths empty) → Add marketplace
3. Restart the app, open the Plugins Directory, choose the Run Coach marketplace and install Coach

Or with the Codex CLI: codex plugin marketplace add chenhunghan/garmin-mcp-app then codex plugin add garmin@garmin-mcp.

Coach then appears in the sidebar (daily briefing and performance dashboard) and as a Training Week tab in conversations; or just ask "@Coach how am I today?". It runs on your computer, so it works in the desktop app only.

Other MCP clients (Cursor, VS Code, Claude Code, Codex CLI, …)

Requires Node.js 20+. Add the server to your client's MCP config:

{  "mcpServers": {    "garmin": { "command": "npx", "args": ["-y", "garmin-mcp-app"] }  }}

Or from the command line: claude mcp add garmin -- npx -y garmin-mcp-app (Claude Code), codex mcp add garmin -- npx -y garmin-mcp-app (Codex CLI).

Clients that support MCP Apps (e.g. VS Code) show the interactive charts and the sign-in form. Other clients still get every Garmin tool as data, but can't show the sign-in form: sign in once from an MCP Apps client — the tokens are saved in ~/.garminconnect and shared by every client on your computer.

What you can do

Ask Claude about your health, training, and fitness — it reads your Garmin data and shows interactive charts right in the conversation.

• Start your day — a morning briefing: readiness, sleep, HRV, body battery and resting HR against your own baselines, with Claude's suggestions
• See your trends — compare up to 4 metrics over 4 weeks to a year, and ask Claude what changed
• Plan your week — Claude designs a week of training from your data, then creates and schedules the workouts on your Garmin calendar
• Analyze your workouts — per-km splits (even for single-lap runs), HR zones, and training effect
• Track your fitness — training readiness, training load, VO2 Max, race predictions, and 30+ more Garmin metrics

Your Garmin, coached by Claude

The app frames your data against your own baselines; Claude reads it and suggests what to do. Every view has Ask Claude questions built from your numbers, and Claude knows what you're looking at.

Daily briefing — "How am I today?"

[Daily briefing: training readiness 72 with its factors, and tiles for sleep, HRV, body battery, resting HR, stress and steps, each compared with a personal baseline]

Performance dashboard — "How has my fitness trended this year?"

[Performance dashboard switching from 12 weeks to 1 year: resting HR, HRV with its baseline band, VO2 max and sleep score as small trend charts]

Weekly training plan — "Plan my training week" (or the plan-training-week prompt)

[Training week: planned workouts paired with completed runs, rest days, and today's long run still to come]

Per-km splits — "Show the splits of my last run"

[Per-km splits table with pace bars, the fastest kilometre highlighted, HR and cadence per km]

_{Screenshots use the built-in demo mode (npm run dev:ui:demo): a fictional runner, no real person's data. Light and dark themes follow Claude Desktop.}

What you can visualize

Plot your activities

[activities]

Visualize training readiness

[training readiness]

Privacy & Security

No data is stored or collected by this app. Your data flows directly between your machine and the Garmin Connect API — there is no intermediate server.

git clone https://github.com/chenhunghan/garmin-mcp-app.gitcd garmin-mcp-appnpm install

git config --unset-all --local core.hooksPathnpm run prepare

npm run dev        # watch-build server + UInpm run dev:ui     # standalone UI dev at localhost:5173npm run test:lib   # run garmin-connect testsnpm run pack       # build + package .mcpb bundle

{  "mcpServers": {    "garmin-mcp": {      "command": "node",      "args": ["/absolute/path/to/garmin-mcp-app/dist/index.js"]    }  }}

type(optional-scope): description

Disclaimer

Run Coach is an independent, open-source project. It is not affiliated with, endorsed by, or sponsored by Garmin Ltd. or its subsidiaries. Garmin and Garmin Connect are trademarks of Garmin Ltd. or its subsidiaries; they are used here only to describe compatibility. The app uses the unofficial Garmin Connect API with your own account.