mcp-garmin

MCP server exposing Garmin Connect data to Claude Desktop.

Setup

1. Install dependencies

python -m venv .venv
.venv/bin/pip install "mcp[cli]" garminconnect

2. Configure Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "/absolute/path/to/mcp-garmin/.venv/bin/python",
      "args": ["/absolute/path/to/mcp-garmin/server.py"],
      "env": {
        "GARMIN_EMAIL": "your@email.com",
        "GARMIN_PASSWORD": "yourpassword"
      }
    }
  }
}

Replace /absolute/path/to/mcp-garmin with the actual path to this directory.

3. Restart Claude Desktop

Quit and relaunch Claude Desktop to pick up the new server config.

4. First-time authentication

On first use (no cached session in ~/.garth), ask Claude:

"Call authenticate()"

If Garmin requires MFA, a prompt will appear in the chat. Check your email or phone for the code, then:

"Call complete_mfa with code 123456"

Once authenticated, the session is cached in ~/.garth. Future server restarts will log in silently without MFA.

Available Tools

Tool	Parameters	Description
`authenticate()`	—	Initiate Garmin login
`complete_mfa(code)`	`code: str`	Provide MFA code to finish login
`get_activities(start_date, end_date, limit)`	all optional	List recent activities
`get_activity_details(activity_id)`	`activity_id: str`	Full detail for one activity
`get_sleep(date)`	optional	Sleep score and stages
`get_heart_rate(date)`	optional	Resting HR and daily timeline
`get_stress(date)`	optional	Stress level timeline
`get_body_battery(date)`	optional	Body battery charge/drain
`get_hrv(date)`	optional	HRV status and nightly average
`get_spo2(date)`	optional	Blood oxygen readings
`get_steps(date)`	optional	Step count and daily goal
`get_daily_stats(date)`	optional	Calories, floors, intensity minutes
`get_devices()`	—	Paired Garmin devices
`get_gear()`	—	Gear items with mileage stats
`get_user_profile()`	—	Profile, age, weight, HR zones

All date parameters accept YYYY-MM-DD format and default to today when omitted.

Running Tests

.venv/bin/pytest tests/ -v

2.3 KiB Raw Blame History