Skip to main content
Glama

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-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

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

The 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-setup

This will:

  1. Log in to Garmin Connect

  2. 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)

  3. 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 test

To test locally:

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

Credits

License

MIT

Available Tools

97 tools
add_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

    A3.6/5.0

    Scored across 97 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      This 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
    • F
      license
      A
      quality
      C
      maintenance
      A 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
      -
    • A
      license
      A
      quality
      B
      maintenance
      This 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.
      26
      45 npm
      MIT