garmin-connect-personal-api-mcp

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

For Claude on the web and on mobile, and any other client that connects to remote servers with OAuth. The free plan is enough, apart from one known limitation.

• One click:

  

• Manual: follow docs/DEPLOY.md.

Then connect your MCP client, such as Claude, ChatGPT, Cursor or VS Code.

Tools

Tool	What it returns
garmin_get_day	One day at a glance: sleep, HRV, Body Battery, stress, resting HR, intensity minutes, activities
garmin_get_days	The same over a date range, one row per day, with daily activity totals and training load
garmin_search_activities	Activities in a date range with Garmin IDs and fastest splits, or totals per week
garmin_get_activity	One activity in depth: pace, HR zones, running dynamics, power, training effect, interval totals, strength sets per exercise
garmin_get_activity_streams	One activity's time series (HR, pace, grade-adjusted pace, cadence, power, elevation, …)
garmin_get_activity_laps	One row per lap and interval rep, from the activity's FIT file
garmin_get_sleep	One night's sleep in detail: score components with optimal ranges, sleep need and why it changed, naps
garmin_get_sleep_summaries	Sleep per night over a date range
garmin_get_hrv	One night's HRV with baseline, status and overnight readings
garmin_get_hrv_summaries	HRV per night over a date range
garmin_get_daily_summaries	Resting HR, Body Battery, stress, intensity minutes, steps per day over a date range
garmin_get_weight	Weigh-ins and body composition over a date range
garmin_get_profile	Profile settings and heart-rate zones
garmin_get_body_battery	Body Battery per day: charged, drained and the sleep / activity events behind it
garmin_get_stress	Stress per day: average level and minutes at rest / low / medium / high
garmin_get_steps	Steps per day with goal and distance
garmin_get_heart_rate	One day's resting / min / max heart rate, optionally averaged per 15 minutes
garmin_get_spo2	One day's blood oxygen (Pulse Ox), optionally hourly with altitude
garmin_get_fitness_age	Fitness age and its components (resting HR, BMI, vigorous days / minutes)
garmin_get_heart_rate_zones	Heart-rate zones per sport
garmin_get_weight_goals	Weight goals in effect (target kg)
garmin_get_activity_workouts	The structured workout an activity followed: steps, targets (HR, pace, power) and repeats
garmin_get_hydration	Hydration per day: intake, goal, sweat loss (ml)
garmin_get_food_log	One day's food log: calories and macros eaten vs. goals, per meal and food
garmin_get_wellness_activities	Wellness sessions (e.g. Health Snapshot, breathwork) with HR, stress, HRV, SpO2
garmin_get_menstrual_cycle	Cycle day, period and fertile window, predictions and cycle analysis
garmin_get_menstrual_day	One day's logged flow, symptoms and moods, with that day's cycle summary

Good to know

• Range tools default to the last 7 days. If a range is too long for one Garmin request, the error says the maximum and the assistant splits it into several calls.
• Output is metric, with the unit in every field name. Dates are YYYY-MM-DD in your time zone; sleep and HRV are keyed by the wake-up date.
• Location, sexual activity and sex drive data are never returned.
• Known limitation: garmin_get_activity_laps can fail on long activities on the Cloudflare free plan. See Known limitations.

Development

Requires Node.js 24+.

npm install
cp .dev.vars.example .dev.vars   # then add GARMIN_API_KEY and OWNER_PASSPHRASE
npm run check                     # typecheck, lint, format check, tests
npm run today                     # print today's recovery data using your key
npm run dev                       # MCP server at http://localhost:8787/mcp
npm run build                     # local server in dist/cli.mjs

To try the local server, connect the MCP Inspector to it and sign in with OWNER_PASSPHRASE.

Architecture and conventions: docs/DEVELOPMENT.md.

License

MIT