Garmin Connect Personal API
hannta/garmin-connect-personal-api-mcp
Read-only Garmin Connect data on Garmin's official Personal API: training, sleep, HRV, recovery.
- tools
- 27
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 6, 2026
Tools
27 toolsPublic tool metadata for what this MCP can expose to an agent.
garmin_get_dayOne day at a glance: sleep, HRV, Body Battery, stress, resting HR, intensity minutes, activities
One day at a glance: sleep, HRV, Body Battery, stress, resting HR, intensity minutes, activities
No parameter schema in public metadata yet.
garmin_get_daysThe same over a date range, one row per day, with daily activity totals and training load
The same over a date range, one row per day, with daily activity totals and training load
No parameter schema in public metadata yet.
garmin_search_activitiesActivities in a date range with Garmin IDs and fastest splits, or totals per week
Activities in a date range with Garmin IDs and fastest splits, or totals per week
No parameter schema in public metadata yet.
garmin_get_activityOne activity in depth: pace, HR zones, running dynamics, power, training effect, interval totals, strength sets per exercise
One activity in depth: pace, HR zones, running dynamics, power, training effect, interval totals, strength sets per exercise
No parameter schema in public metadata yet.
garmin_get_activity_streamsOne activity's time series (HR, pace, grade-adjusted pace, cadence, power, elevation, …)
One activity's time series (HR, pace, grade-adjusted pace, cadence, power, elevation, …)
No parameter schema in public metadata yet.
garmin_get_activity_lapsOne row per lap and interval rep, from the activity's FIT file
One row per lap and interval rep, from the activity's FIT file
No parameter schema in public metadata yet.
garmin_get_sleepOne night's sleep in detail: score components with optimal ranges, sleep need and why it changed, naps
One night's sleep in detail: score components with optimal ranges, sleep need and why it changed, naps
No parameter schema in public metadata yet.
garmin_get_sleep_summariesSleep per night over a date range
Sleep per night over a date range
No parameter schema in public metadata yet.
garmin_get_hrvOne night's HRV with baseline, status and overnight readings
One night's HRV with baseline, status and overnight readings
No parameter schema in public metadata yet.
garmin_get_hrv_summariesHRV per night over a date range
HRV per night over a date range
No parameter schema in public metadata yet.
garmin_get_daily_summariesResting HR, Body Battery, stress, intensity minutes, steps per day over a date range
Resting HR, Body Battery, stress, intensity minutes, steps per day over a date range
No parameter schema in public metadata yet.
garmin_get_weightWeigh-ins and body composition over a date range
Weigh-ins and body composition over a date range
No parameter schema in public metadata yet.
garmin_get_profileProfile settings and heart-rate zones
Profile settings and heart-rate zones
No parameter schema in public metadata yet.
garmin_get_body_batteryBody Battery per day: charged, drained and the sleep / activity events behind it
Body Battery per day: charged, drained and the sleep / activity events behind it
No parameter schema in public metadata yet.
garmin_get_stressStress per day: average level and minutes at rest / low / medium / high
Stress per day: average level and minutes at rest / low / medium / high
No parameter schema in public metadata yet.
garmin_get_stepsSteps per day with goal and distance
Steps per day with goal and distance
No parameter schema in public metadata yet.
garmin_get_heart_rateOne day's resting / min / max heart rate, optionally averaged per 15 minutes
One day's resting / min / max heart rate, optionally averaged per 15 minutes
No parameter schema in public metadata yet.
garmin_get_spo2One day's blood oxygen (Pulse Ox), optionally hourly with altitude
One day's blood oxygen (Pulse Ox), optionally hourly with altitude
No parameter schema in public metadata yet.
garmin_get_fitness_ageFitness age and its components (resting HR, BMI, vigorous days / minutes)
Fitness age and its components (resting HR, BMI, vigorous days / minutes)
No parameter schema in public metadata yet.
garmin_get_heart_rate_zonesHeart-rate zones per sport
Heart-rate zones per sport
No parameter schema in public metadata yet.
garmin_get_weight_goalsWeight goals in effect (target kg)
Weight goals in effect (target kg)
No parameter schema in public metadata yet.
garmin_get_activity_workoutsThe structured workout an activity followed: steps, targets (HR, pace, power) and repeats
The structured workout an activity followed: steps, targets (HR, pace, power) and repeats
No parameter schema in public metadata yet.
garmin_get_hydrationHydration per day: intake, goal, sweat loss (ml)
Hydration per day: intake, goal, sweat loss (ml)
No parameter schema in public metadata yet.
garmin_get_food_logOne day's food log: calories and macros eaten vs. goals, per meal and food
One day's food log: calories and macros eaten vs. goals, per meal and food
No parameter schema in public metadata yet.
garmin_get_wellness_activitiesWellness sessions (e.g. Health Snapshot, breathwork) with HR, stress, HRV, SpO2
Wellness sessions (e.g. Health Snapshot, breathwork) with HR, stress, HRV, SpO2
No parameter schema in public metadata yet.
garmin_get_menstrual_cycleCycle day, period and fertile window, predictions and cycle analysis
Cycle day, period and fertile window, predictions and cycle analysis
No parameter schema in public metadata yet.
garmin_get_menstrual_dayOne day's logged flow, symptoms and moods, with that day's cycle summary
One day's logged flow, symptoms and moods, with that day's cycle summary
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GARMIN_PERSONAL_API_KEYsecretGarmin Connect Personal API key (optional: the auth command saves one instead)
Readme
Watch with a heart-rate line
Garmin Connect Personal API MCP
Not affiliated with or endorsed by Garmin. Garmin and Garmin Connect are trademarks of Garmin Ltd.
A read-only MCP server that gives AI assistants your own Garmin Connect training, recovery and health data through the official Garmin Connect Personal API. Run it on your own computer, or host it on your own Cloudflare account to use it from anywhere.
AI agents: to set this up for a user, follow docs/AGENT-SETUP.md.
Setup
You need a Garmin Connect Personal API key, which you create in Garmin Connect on the web.
Run locally
The quickest way, for Claude Code, Claude Desktop, Cursor, VS Code and other clients that run local servers. Needs Node.js 22+.
Paste this into your coding agent:
Connect @hannta/garmin-connect-personal-api-mcp
Or do it yourself: docs/LOCAL.md.
Host on Cloudflare
Details
- Repository
- github.com/hannta/garmin-connect-personal-api-mcp
- Website
- github.com/hannta/garmin-connect-personal-api-mcp#readme
- Category
- Data & Analytics
- Package
@hannta/garmin-connect-personal-api-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
