How do I install Garmin Connect MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Garmin Connect MCP safe to use with an AI agent?

Its trust score is 52 out of 100 (fair). It passes 4 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Garmin Connect MCP still maintained?

Yes — the last commit was 2 months ago. The repository has 185 stars and 95 forks and 6 open issues.

About Garmin Connect MCP

Garmin Connect MCP is an MCP server published by Nicolasvegam in the Healthcare category: mCP server for Garmin Connect — access 61 health, fitness and activity tools from any AI assistant.

The repository has 185 stars and 95 forks, with the last commit 2 months ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source

git clone https://github.com/Nicolasvegam/garmin-connect-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Garmin Connect MCP

I know everything about Garmin Connect MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository just now. Heuristics on the source, not an audit.

✓README presentThe repository ships documentation.
!License declaredNo license file. Legally you have no right to use it in a product.
✓Tests presentA test suite exists in the repository.
✓Dependencies pinnedA lockfile pins dependency versions.
✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.

1 check has not been run yet.

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 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_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='you@email.com' 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:

GARMIN_EMAIL=you@email.com GARMIN_PASSWORD=yourpass npm start

Credits

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

License

MIT

Read full README

README fetched from the repository just now. The original is authoritative.

About Garmin Connect MCP

Install

Ask AI

Security checks

README

garmin-connect-mcp

Requirements

Installation

Claude Code

Claude Desktop

Cursor

Windsurf

Any MCP Client

Available Tools

Activities (12 tools)

Daily Health (14 tools)

Trends (4 tools)

Sleep (2 tools)

Body Composition (5 tools)

Performance & Training (11 tools)

Profile & Devices (13 tools)

Authentication

MFA (Multi-Factor Authentication)

Development

Credits

License

Alternatives to Garmin Connect MCP

Open Pencil

Go MCP

Arc Kit

Kuse Cowork

Archguard

Hapi Fhir Jpaserver Starter

About Garmin Connect MCP