nicolasvegam/garmin-connect-mcp

163 stars 0 forks 品質 90 トレンド 90

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

概要

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

README

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 [email protected] -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": "[email protected]",
        "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": "[email protected]",
        "GARMIN_PASSWORD": "yourpass"
      }
    }
  }
}

Windsurf

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

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

Any MCP Client

Run the server with environment variables:

[email protected] 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_intensity_minutes`	Weekly intensity minutes

Sleep (2 tools)

Tool	Description
`get_sleep_data`	Sleep stages, score, bed/wake times
`get_sleep_data_raw`	Raw sleep data with HR and SpO2

Body Composition (5 tools)

Tool	Description
`get_body_composition`	Weight, BMI, body fat %, muscle mass (date range)
`get_latest_weight`	Most recent weight entry
`get_daily_weigh_ins`	All weigh-ins for a date
`get_weigh_ins`	Weigh-in records over a date range
`get_blood_pressure`	Blood pressure readings (date range)

Performance & Training (11 tools)

Tool	Description
`get_vo2max`	VO2 Max estimate (running/cycling)
`get_training_readiness`	Training Readiness score
`get_training_status`	Training status and load
`get_hrv`	Heart Rate Variability
`get_endurance_score`	Endurance fitness score
`get_hill_score`	Climbing performance score
`get_race_predictions`	5K/10K/half/full marathon predictions
`get_fitness_age`	Estimated fitness age
`get_personal_records`	All personal records
`get_lactate_threshold`	Lactate threshold HR and pace
`get_cycling_ftp`	Functional Threshold Power (cycling)

Profile & Devices (13 tools)

Tool	Description
`get_user_profile`	User social profile and preferences
`get_user_settings`	User settings, measurement system, sleep schedule
`get_devices`	Registered Garmin devices
`get_device_settings`	Settings for a specific device
`get_device_last_used`	Last used device info
`get_primary_training_device`	Primary training device
`get_device_solar_data`	Solar charging data
`get_gear`	All tracked gear/equipment
`get_gear_stats`	Usage stats for a gear item
`get_goals`	Active goals and progress
`get_earned_badges`	Earned badges and achievements
`get_workouts`	Saved workouts
`get_workout`	Specific workout by ID

Authentication

Uses Garmin Connect credentials (email/password) via environment variables. OAuth tokens are cached in ~/.garmin-mcp/ to avoid re-authentication on each request.

MFA (Multi-Factor Authentication)

If your Garmin account has MFA enabled (required for devices with ECG capabilities), you need to run the interactive setup once before using the MCP server:

GARMIN_EMAIL='[email protected]' GARMIN_PASSWORD='yourpass' npx -y @nicolasvegam/garmin-connect-mcp setup

This will:

Log in to Garmin Connect
Prompt you for the MFA code sent to your email or authenticator app
Save OAuth tokens to ~/.garmin-mcp/

After setup, the MCP server will use the saved tokens automatically — no MFA prompt needed until the tokens expire. When they do, simply run the setup command again.

Development

git clone https://github.com/Nicolasvegam/garmin-connect-mcp.git
cd garmin-connect-mcp
npm install
npm run build

To test locally:

[email protected] GARMIN_PASSWORD=yourpass npm start

Credits

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

License

MIT

View this README on GitHub

インストール

npx -y @nicolasvegam/garmin-connect-mcp

設定

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