mcp-garmin

MCP server for Garmin Connect health and fitness data. Read-only access to daily health metrics, activities, workouts, and body composition via the python-garminconnect library.

Prerequisites

• Python 3.14+
• uv
• A Garmin Connect account

Authentication

Garmin Connect uses email/password authentication with optional MFA. The library persists session tokens to ~/.garminconnect/garmin_tokens.json after initial login.

First-time setup

Run the interactive login command to establish tokens. This handles MFA prompts:

# Set credentials (or the CLI will prompt you)
export GARMIN_EMAIL="you@example.com"
export GARMIN_PASSWORD="your-password"

# Interactive login -- prompts for MFA if enabled
uvx mcp-garmin-login

Running the server

The MCP server requires GARMIN_EMAIL and GARMIN_PASSWORD environment variables. It reuses tokens saved by the login step and refreshes them automatically.

export GARMIN_EMAIL="you@example.com"
export GARMIN_PASSWORD="your-password"

Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": ["mcp-garmin"],
      "env": {
        "GARMIN_EMAIL": "you@example.com",
        "GARMIN_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add garmin -- uvx mcp-garmin

Set GARMIN_EMAIL and GARMIN_PASSWORD in your shell environment.

Tools

All date parameters use ISO format (YYYY-MM-DD).

Daily Health

Activities

Workouts

Body Composition

Profile & Fitness

Development

uv sync
uv run pytest tests/ -x -q
uv run ruff check src/ tests/
uv run pyright src/