# Run Coach

Connects Garmin data to an AI client for health views, workout analysis, trends, and weekly planning. Sign-in is needed on first use.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: chenhunghan
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chenhunghan/garmin-mcp-app
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/run-coach

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add garmin-mcp-app -- npx -y garmin-mcp-app
```

### Codex

**Platform CLI**
```bash
codex mcp add run-coach -- npx -y garmin-mcp-app
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "run-coach": {
            "command": "npx",
            "args": [
                "-y",
                "garmin-mcp-app"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "run-coach": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "garmin-mcp-app"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add run-coach npx -y garmin-mcp-app
```

## When to use it
- 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
- 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.

## Similar
- [running-race-coach](https://affpapa.org/en/nevibecode/plugins/running-race-coach.md) — plugin · ★ 30
- [kaiord](https://affpapa.org/en/nevibecode/mcp/kaiord.md) — MCP server · ★ 10
- [garmin-local-mcp](https://affpapa.org/en/nevibecode/mcp/garmin-local-mcp.md) — MCP server · ★ 9
- [Garmin Connect](https://affpapa.org/en/nevibecode/mcp/garmin-connect.md) — MCP server · ★ 37
- [Coach Watts](https://affpapa.org/en/nevibecode/mcp/coach-watts.md) — MCP server · ★ 104
- [fitness-coach](https://affpapa.org/en/nevibecode/skills/fitness-coach.md) — skill · 822 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md