garmin-connect-mcp

MCP server for Garmin Connect. Access your fitness, health, and training data from Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP client.

61 tools across 7 categories: activities, daily health, trends, sleep, body composition, performance/training, and profile/devices.

API endpoints and authentication flow based on python-garminconnect by cyberjunky.

Requirements

• Node.js 20+
• A Garmin Connect account (email and password)

Installation

Claude Code

claude mcp add garmin -e GARMIN_EMAIL=you@email.com -e GARMIN_PASSWORD=yourpass -- npx -y @nicolasvegam/garmin-connect-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "you@email.com",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "you@email.com",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "you@email.com",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Any MCP Client

Run the server with environment variables:

GARMIN_EMAIL=you@email.com GARMIN_PASSWORD=yourpass npx -y @nicolasvegam/garmin-connect-mcp

The server communicates over stdio using the Model Context Protocol.

Available Tools

Activities (12 tools)

Tool	Description
get_activities	List recent activities with pagination
get_activities_by_date	Search activities within a date range
get_last_activity	Get the most recent activity
count_activities	Get total number of activities
get_activity	Summary data for a specific activity
get_activity_details	Detailed metrics: HR, pace, elevation time series
get_activity_splits	Per-km or per-mile split data
get_activity_weather	Weather conditions during activity
get_activity_hr_zones	Time in each heart rate zone
get_activity_exercise_sets	Strength training sets (reps, weight)
get_activity_types	All available activity types
get_progress_summary	Fitness stats over a date range by activity type

Daily Health (14 tools)

Tool	Description
get_daily_summary	Full daily summary (steps, calories, distance, etc.)
get_steps	Step count for a date
get_steps_chart	Intraday step data throughout the day
get_heart_rate	Heart rate data (resting, max, zones, time series)
get_resting_heart_rate	Resting heart rate for a date
get_stress	Stress levels and time series
get_body_battery	Body Battery energy levels (date range)
get_body_battery_events	Battery charge/drain events for a day
get_respiration	Breathing rate data
get_spo2	Blood oxygen saturation
get_intensity_minutes	Moderate/vigorous intensity minutes
get_floors	Floors climbed chart data
get_hydration	Daily hydration/water intake
get_daily_events	Daily wellness events

Trends (4 tools)

Tool	Description
get_daily_steps_range	Daily step counts over a date range
get_weekly_steps	Weekly step aggregates
get_weekly_stress	Weekly stress aggregates
`get_weekly

... View full README on GitHub