garmin-connect-mcp
This MCP server provides authenticated access to Garmin Connect so you can retrieve, analyze, and modify fitness, health, sleep, training, profile, device, gear, goal, badge, workout, and women’s-health data.
List, search, count, and inspect activities with details, splits, weather, HR zones, exercise sets, gear, progress summaries, and activity types.
Rename activities, create manual activities, delete activities, and link/unlink gear.
Query daily health and trends: steps, heart rate, stress, Body Battery, respiration, SpO2, intensity minutes, floors, hydration, daily events, weekly/range summaries, and combined health snapshots.
Read sleep data, body composition, weigh-ins, and blood pressure; add weigh-ins, set hydration, and record blood pressure.
Access performance/training metrics: VO2 Max, Training Readiness/Status, HRV, Endurance/Hill scores, race predictions, fitness age, personal records, lactate threshold, cycling FTP, and date ranges.
View profile/settings, devices, device settings/solar data, gear stats/defaults, goals, badges/challenges, workouts, and training plans.
Query menstrual cycle data, pregnancy summary, and lifestyle logging.
Authenticate with Garmin credentials; OAuth tokens are cached, with one-time terminal setup for MFA.
Allows access to Garmin Connect fitness, health, and training data, providing tools for retrieving activities, daily health metrics (steps, heart rate, stress, sleep), body composition, performance stats (VO2 Max, training readiness), and device information.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@garmin-connect-mcp What was my sleep score last night and what's my current training readiness?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Related MCP server: garmin-mcp
Installation
Claude Code
claude mcp add garmin -e GARMIN_EMAIL=you@email.com -e GARMIN_PASSWORD=yourpass -- npx -y @nicolasvegam/garmin-connect-mcpClaude 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-mcpThe server communicates over stdio using the Model Context Protocol.
Available Tools
Activities (12 tools)
Tool | Description |
| List recent activities with pagination |
| Search activities within a date range |
| Get the most recent activity |
| Get total number of activities |
| Summary data for a specific activity |
| Detailed metrics: HR, pace, elevation time series |
| Per-km or per-mile split data |
| Weather conditions during activity |
| Time in each heart rate zone |
| Strength training sets (reps, weight) |
| All available activity types |
| Fitness stats over a date range by activity type |
Daily Health (14 tools)
Tool | Description |
| Full daily summary (steps, calories, distance, etc.) |
| Step count for a date |
| Intraday step data throughout the day |
| Heart rate data (resting, max, zones, time series) |
| Resting heart rate for a date |
| Stress levels and time series |
| Body Battery energy levels (date range) |
| Battery charge/drain events for a day |
| Breathing rate data |
| Blood oxygen saturation |
| Moderate/vigorous intensity minutes |
| Floors climbed chart data |
| Daily hydration/water intake |
| Daily wellness events |
Trends (4 tools)
Tool | Description |
| Daily step counts over a date range |
| Weekly step aggregates |
| Weekly stress aggregates |
| Weekly intensity minutes |
Sleep (2 tools)
Tool | Description |
| Sleep stages, score, bed/wake times |
| Raw sleep data with HR and SpO2 |
Body Composition (5 tools)
Tool | Description |
| Weight, BMI, body fat %, muscle mass (date range) |
| Most recent weight entry |
| All weigh-ins for a date |
| Weigh-in records over a date range |
| Blood pressure readings (date range) |
Performance & Training (11 tools)
Tool | Description |
| VO2 Max estimate (running/cycling) |
| Training Readiness score |
| Training status and load |
| Heart Rate Variability |
| Endurance fitness score |
| Climbing performance score |
| 5K/10K/half/full marathon predictions |
| Estimated fitness age |
| All personal records |
| Lactate threshold HR and pace |
| Functional Threshold Power (cycling) |
Profile & Devices (13 tools)
Tool | Description |
| User social profile and preferences |
| User settings, measurement system, sleep schedule |
| Registered Garmin devices |
| Settings for a specific device |
| Last used device info |
| Primary training device |
| Solar charging data |
| All tracked gear/equipment |
| Usage stats for a gear item |
| Active goals and progress |
| Earned badges and achievements |
| Saved workouts |
| 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 setupThe same flow is available as its own executable, garmin-connect-mcp-setup:
GARMIN_EMAIL='you@email.com' GARMIN_PASSWORD='yourpass' npx -y --package @nicolasvegam/garmin-connect-mcp garmin-connect-mcp-setupThis will:
Log in to Garmin Connect
Prompt you for the MFA code sent to your email or authenticator app (the setup command asks for the code on the terminal; the MCP server itself cannot)
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
npm testTo test locally:
GARMIN_EMAIL=you@email.com GARMIN_PASSWORD=yourpass npm startCredits
API endpoints and authentication flow based on
python-garminconnectby cyberjunky
License
MIT
Available Tools
97 toolsadd_gear_to_activityB
Link a gear item (shoes, bike) to an activity
Inputs: gearUuid (required), activityId (required).
add_weigh_inC
Record a weight measurement
Inputs: weight (required), unitKey, date.
count_activitiesA
Get total number of activities
Inputs: no named parameters.
create_manual_activityA
Create a manual activity entry. Use get_activity_types to find valid activityTypeKey values
Inputs: activityName (required), activityTypeKey (required), startTimeInGMT (required), elapsedDurationInSecs (required), +1 more.
delete_activityA
Delete an activity permanently. This action cannot be undone
Inputs: activityId (required).
get_activitiesA
Get recent activities with pagination. Returns activity summaries: type, duration, distance, calories, heart rate
Inputs: start, limit, activityType.
get_activities_by_dateB
Search activities within a date range, optionally filtered by activity type (running, cycling, etc.)
Inputs: startDate (required), endDate (required), activityType.
get_activityB
Get summary data for a specific activity
Inputs: activityId (required).
get_activity_detailsC
Get detailed activity metrics: HR, pace, elevation, cadence, power time series data
Inputs: activityId (required).
get_activity_exercise_setsA
Get exercise set details for strength training activities: reps, weight, duration per set
Inputs: activityId (required).
get_activity_gearA
Get gear/equipment used during a specific activity
Inputs: activityId (required).
get_activity_hr_zonesA
Get time spent in each heart rate zone during an activity
Inputs: activityId (required).
get_activity_power_in_timezonesB
Get power time in zones for cycling/running power activities
Inputs: activityId (required).
get_activity_splitsB
Get per-km or per-mile split data for an activity
Inputs: activityId (required).
get_activity_split_summariesB
Get split summary data for an activity with aggregate stats per split
Inputs: activityId (required).
get_activity_typed_splitsA
Get typed split data for an activity (e.g. active vs rest intervals)
Inputs: activityId (required).
get_activity_typesA
Get all available activity types (running, cycling, swimming, etc.)
Inputs: no named parameters.
get_activity_weatherB
Get weather conditions during an activity: temperature, humidity, wind, condition
Inputs: activityId (required).
get_adaptive_training_plan_by_idB
Get an adaptive (Garmin Coach) training plan by ID
Inputs: planId (required).
get_adhoc_challengesB
Get historical ad-hoc challenges the user has participated in
Inputs: no named parameters.
get_available_badge_challengesB
Get available badge challenges that can be joined
Inputs: no named parameters.
get_available_badgesA
Get all available badges that can be earned
Inputs: no named parameters.
get_badge_challengesA
Get completed badge challenges
Inputs: no named parameters.
get_blood_pressureA
Get blood pressure readings over a date range
Inputs: startDate (required), endDate (required).
get_body_batteryA
Get Body Battery energy levels: charged, drained, highest, lowest. endDate defaults to startDate if omitted
Inputs: startDate (required), endDate.
get_body_battery_eventsA
Get Body Battery charge and drain events for a day (what charged/drained your battery)
Inputs: date.
get_body_compositionB
Get body composition data over a date range: weight, BMI, body fat %, muscle mass, bone mass, body water %
Inputs: startDate (required), endDate (required).
get_cycling_ftpA
Get latest Functional Threshold Power (FTP) for cycling
Inputs: no named parameters.
get_daily_eventsC
Get daily wellness events for a specific date
Inputs: date.
get_daily_health_snapshotA
Get complete daily health snapshot in a single call: summary, heart rate, stress, body battery, sleep, HRV, respiration, SpO2, steps, floors, intensity minutes. Calls ~11 endpoints in parallel. Use yesterday if today has no data yet
Inputs: date.
get_daily_steps_rangeA
Get daily step counts over a date range for trend analysis. Auto-chunks ranges >28 days
Inputs: startDate (required), endDate (required).
get_daily_summaryA
Get full daily summary: steps, calories, distance, floors, active minutes, heart rate, stress, body battery
Inputs: date.
get_daily_weigh_insB
Get all weigh-in entries for a specific date
Inputs: date.
get_device_last_usedA
Get the last used Garmin device info
Inputs: no named parameters.
get_devicesA
Get all registered Garmin devices: model, firmware, last sync
Inputs: no named parameters.
get_device_settingsB
Get settings and configuration for a specific Garmin device
Inputs: deviceId (required).
get_device_solar_dataA
Get solar charging data for solar-equipped Garmin devices
Inputs: deviceId (required), startDate (required), endDate (required).
get_earned_badgesA
Get all earned badges and achievements
Inputs: no named parameters.
get_endurance_scoreA
Get Endurance Score. Single date: omit endDate. Date range: provide both with optional aggregation (daily/weekly/monthly)
Inputs: startDate (required), endDate, aggregation.
get_fitness_ageC
Get Garmin Fitness Age estimate based on fitness level, activity, and body metrics
Inputs: date.
get_floorsB
Get floors climbed chart data for a specific date
Inputs: date.
get_gearA
Get all gear/equipment: shoes, bikes, and other tracked equipment
Inputs: no named parameters.
get_gear_activitiesA
Get activities associated with a specific gear item (e.g. runs with a specific pair of shoes)
Inputs: gearUuid (required), start, limit.
get_gear_defaultsA
Get default gear assignments per activity type
Inputs: no named parameters.
get_gear_statsB
Get usage statistics for a specific gear item (total distance, activities)
Inputs: gearUuid (required).
get_goalsA
Get active goals: step goals, activity goals, weight goals, and their progress
Inputs: no named parameters.
get_heart_rateA
Get daily heart rate data: resting HR, max HR, min HR, and time series throughout the day
Inputs: date.
get_hill_scoreB
Get Hill Score. Single date: omit endDate. Date range: provide both with optional aggregation (daily/weekly/monthly)
Inputs: startDate (required), endDate, aggregation.
get_hrvA
Get Heart Rate Variability (HRV) data. Key recovery indicator. Data may not be available for today, use yesterday. For ranges use get_hrv_range
Inputs: date.
get_hrv_rangeB
Get HRV data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_hydrationC
Get daily hydration data (water intake)
Inputs: date.
get_inprogress_virtual_challengesB
Get virtual challenges currently in progress
Inputs: no named parameters.
get_intensity_minutesA
Get moderate and vigorous intensity minutes for a date
Inputs: date.
get_lactate_thresholdA
Get lactate threshold data: HR and pace. Omit dates for latest. Provide dates for historical trend with aggregation (daily/weekly/monthly)
Inputs: startDate, endDate, aggregation.
get_last_activityC
Get the most recent activity
Inputs: no named parameters.
get_latest_weightB
Get the most recent weight entry
Inputs: no named parameters.
get_lifestyle_logging_dataC
Get daily lifestyle logging data for a date
Inputs: date.
get_menstrual_calendar_dataA
Get menstrual cycle calendar data for a date range: cycle phases, predictions, symptoms
Inputs: startDate (required), endDate (required).
get_menstrual_data_for_dateB
Get menstrual cycle day view for a specific date: current phase, symptoms, predictions
Inputs: date.
get_non_completed_badge_challengesA
Get badge challenges that are started but not yet completed
Inputs: no named parameters.
get_personal_recordsA
Get personal records: longest run, fastest 5K/10K/half/full marathon, longest ride
Inputs: no named parameters.
get_pregnancy_summaryB
Get pregnancy tracking summary data
Inputs: no named parameters.
get_primary_training_deviceC
Get the primary training device info
Inputs: no named parameters.
get_progress_summaryB
Get fitness progress stats over a date range: distance, duration, or calories grouped by activity type
Inputs: startDate (required), endDate (required), metric.
get_race_predictionsA
Get race time predictions for 5K, 10K, half marathon, and marathon. Omit dates for latest. Provide dates for historical (daily/monthly)
Inputs: startDate, endDate, type.
get_respirationA
Get daily respiration rate data throughout the day. Single date; for ranges use get_respiration_range
Inputs: date.
get_respiration_rangeA
Get respiration data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_resting_heart_rateB
Get resting heart rate data for a specific date
Inputs: date.
get_scheduled_workout_by_idB
Get a specific scheduled workout by ID from a training plan
Inputs: workoutId (required).
get_sleep_dataA
Get detailed sleep data for a single night: duration, sleep stages (deep, light, REM, awake), sleep score, bed/wake times. For multiple nights use get_sleep_data_range
Inputs: date.
get_sleep_data_rangeA
Get sleep data over a date range (day-by-day). Returns array of {date, data} records with sleep stages, score, duration
Inputs: startDate (required), endDate (required).
get_sleep_data_rawB
Get raw sleep data directly from the wellness service with full detail including heart rate and SpO2 during sleep
Inputs: date.
get_spo2A
Get blood oxygen saturation (SpO2) data for a specific date. Single date; for ranges use get_spo2_range
Inputs: date.
get_spo2_rangeA
Get SpO2 (blood oxygen) data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_stepsB
Get step count for a specific date
Inputs: date.
get_steps_chartB
Get detailed intraday step data throughout the day (step chart)
Inputs: date.
get_stressA
Get daily stress levels: overall score, time in rest/low/medium/high stress, and time series. Single date; for ranges use get_stress_range
Inputs: date.
get_stress_rangeA
Get daily stress data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_training_plan_by_idA
Get a specific training plan by ID with full schedule and workout details
Inputs: planId (required).
get_training_plansA
Get all training plans from Garmin Coach or custom plans
Inputs: no named parameters.
get_training_readinessA
Get Training Readiness score: combines sleep, recovery, training load and HRV. Data may not be available for today, use yesterday. For ranges use get_training_readiness_range
Inputs: date.
get_training_readiness_rangeA
Get Training Readiness data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_training_statusA
Get Training Status: productive, maintaining, detraining, peaking, recovery, overreaching. Includes training load. Data may not be available for today
Inputs: date.
get_user_profileA
Get user social profile: name, location, profile image, activity preferences, level
Inputs: no named parameters.
get_user_settingsA
Get user settings: measurement system, time/date format, sleep schedule, HR zones, hydration preferences
Inputs: no named parameters.
get_vo2maxA
Get VO2 Max estimate for a date (running and cycling). Data may not be available for today, use yesterday. For ranges use get_vo2max_range
Inputs: date.
get_vo2max_rangeA
Get VO2 Max data over a date range (day-by-day). Returns array of {date, data} records
Inputs: startDate (required), endDate (required).
get_weekly_intensity_minutesC
Get weekly intensity minutes over a date range
Inputs: startDate (required), endDate (required).
get_weekly_stepsA
Get weekly aggregated step counts for trend analysis. Defaults to 52 weeks (1 year). Max 52 weeks
Inputs: endDate (required), weeks.
get_weekly_stressA
Get weekly aggregated stress data for trend analysis. Defaults to 52 weeks (1 year). Max 52 weeks
Inputs: endDate (required), weeks.
get_weigh_insB
Get weigh-in records over a date range
Inputs: startDate (required), endDate (required).
get_workoutA
Get a specific workout definition by ID
Inputs: workoutId (required).
get_workoutsB
Get saved workouts/training plans
Inputs: no named parameters.
remove_gear_from_activityB
Unlink a gear item from an activity
Inputs: gearUuid (required), activityId (required).
set_activity_nameB
Rename an activity
Inputs: activityId (required), name (required).
set_blood_pressureB
Record a blood pressure measurement with systolic, diastolic, and pulse
Inputs: systolic (required), diastolic (required), pulse (required), timestamp, +1 more.
set_hydrationC
Set daily hydration intake in milliliters
Inputs: valueMl (required), date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 97 tools
Each tool targets a distinct data type or operation, with clear boundaries between single-date vs. range variants and composite vs. granular endpoints. The 97 tools cover separate aspects (activities, health metrics, gear, badges, etc.) without significant overlap.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_heart_rate, set_blood_pressure, delete_activity, count_activities). Only a minor deviation with 'count' instead of 'get', but overall the pattern is uniform and predictable.
97 tools is large, but it reflects the comprehensive nature of Garmin Connect's health and fitness data. Each tool serves a specific purpose, and avoiding redundant endpoints would sacrifice usability. The domain justifies the count, though it borders on being heavy.
The set covers virtually all major aspects of the Garmin Connect API: activity CRUD, detailed metrics, health and wellness data (HRV, sleep, stress, etc.), gear management, badges, challenges, training plans, and user settings. There are no obvious gaps that would hinder core workflows.
Maintenance
Related MCP Connectors
Adaptive running coach MCP server — training data, plans, and recovery for AI assistants.
Pace is a remote MCP server that exposes wearable and fitness data to Claude via the Model Context Protocol. It connects to Garmin, Oura, Whoop, Polar, Fitbit and 20+ devices and provides 15 tools for querying sleep, activity, recovery, and training data. Hosted on Google Cloud Run, OAuth 2.1 authentication, Streamable HTTP transport. Instructions: First you need to create an account at: https://pacetraining.co and connect your wearables. After that you can connect the remote Server via Custom Connector in Claude and OAuth 2.1 Flow startet.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Related MCP Servers
- FlicenseAqualityDmaintenanceMCP server that connects AI assistants to Garmin Connect health and fitness data, enabling natural language queries about workouts, sleep, heart rate, and more.29-
- AlicenseNot gradedqualityDmaintenanceThis MCP server exposes Garmin Connect health data—sleep, heart rate, HRV, stress, VO2max, and activities—to Claude through local tools, enabling natural language queries, data syncing, and statistical analysis like correlations and night-out detection.MIT
- FlicenseAqualityCmaintenanceA local MCP server that exposes Garmin Connect activity, health, and training data as tools for Claude Desktop. It provides read-only access to metrics like activities, sleep, heart rate, and training readiness.25-
- AlicenseAqualityBmaintenanceThis server lets Claude, Cursor, or any MCP client read a user's own health and fitness data through 26 read-only tools for activities, sleep, HRV, Body Battery, stress, steps, heart rate, weight, nutrition, and women's health. It connects via the official Personal API and can be self-hosted for free on Vercel.2645 npmMIT