Paceva for Garmin
This server gives read-only MCP access to your own Garmin Connect data, with no added scores or advice.
Get daily overviews: summary, sleep, HRV, and Body Battery for one day.
Query daily summaries over ranges: steps, distance, calories, resting HR, stress, intensity minutes, floors.
Read detailed sleep, overnight HRV, Body Battery, stress, steps, heart rate, and SpO2, optionally with minute-by-minute series.
List and inspect activities, including training logs up to 366 days with distance, time, pace/speed, HR, power, TSS, splits, zones, and structured workouts.
Retrieve profile settings and heart rate zones, weight/body composition, fitness age, hydration, food log, and menstrual cycle data.
Cap general ranges at 92 days and return long series as summary stats unless full series are requested.
Read-only access to a user's own Garmin Connect data through Garmin's Personal API. Provides tools to retrieve daily overviews, daily summaries, sleep, HRV, Body Battery, stress, steps, heart rate, SpO2, weight, fitness age, hydration, food log, menstrual cycle, and profile/heart-rate zones, plus listing activities and fetching full activity details or a training log with distance, pace, heart rate, power, TSS, splits and time-in-zone.
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., "@Paceva for Garmin How did I sleep last night?"
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.
Paceva for Garmin
Ask Claude or any MCP app about your own Garmin data: sleep, HRV, Body Battery, stress, resting heart rate, steps and activities.
"How did I sleep last night?" "Is my HRV trending down this month?" "Compare my last three long runs." "What could I run a half marathon in right now?"
Free, open source and local. It runs on your computer with your own Garmin Personal API key. Your data goes from Garmin to your computer to your AI app, and never through anyone else's server. It's read-only: it can't change anything in Garmin Connect.
Set up
Claude Desktop: one download
Download paceva-garmin.mcpb and open it.
Claude asks for your Garmin key: open Garmin Connect › Personal API Key, select Create Key, copy it, paste it in.
Switch Paceva for Garmin on. Claude installs extensions switched off.
Ask Claude: "How did I sleep last night?"
Everything else: one command
Needs Node.js 20 or newer. In a terminal:
npx github:OwenScheuer/paceva-garmin-mcpIt opens Garmin for you, picks up the key once you've copied it, checks it with Garmin, and adds itself to Claude Desktop, Claude Code, Cursor and Windsurf, whichever you have. Restart the app and ask away.
For any other MCP app, add this to its MCP servers:
"garmin": { "command": "npx", "args": ["-y", "github:OwenScheuer/paceva-garmin-mcp"] }ChatGPT only connects to servers on the internet, not ones on your computer, so it can't use this yet.
New key later? npx github:OwenScheuer/paceva-garmin-mcp --new-key. Check it's working: npx github:OwenScheuer/paceva-garmin-mcp check.
Related MCP server: garmin-owl
What it can read
Tool | What it gives your AI |
| One day at a glance: summary, sleep, HRV and Body Battery |
| Steps, calories, resting HR, stress and intensity minutes per day |
| One night in detail, or nightly summaries over a range |
| Overnight HRV, baseline and status |
| Charged, drained, high and low |
| Daily stress, steps, heart rate and Pulse Ox |
| Every activity in a period (up to a year) with Garmin's main fields: distance, time, speed, heart rate, power, TSS, fastest splits, time in zones |
| Your activities, and any one in full |
| Profile settings and heart rate zones |
| The rest of what Garmin's Personal API offers |
Just Garmin's data. No scores, models or advice are added: every number is Garmin's, in Garmin's own field names and units. Ask "what could I run a 10K in?" and any prediction is your AI's own, made from that data.
Ranges are capped at 92 days per call (a year for the training log). Minute-by-minute series (heart rate through the day, sleep stages) come back as a count, min, max and average unless your AI asks for the full series.
Garmin's Personal API doesn't include training readiness, training status or recovery time, so neither does this.
Your key and your privacy
Your key is saved to
~/.config/garmin/connect-personal-api-key, the same place Garmin's own tools look, readable only by you. You can also setGARMIN_PERSONAL_API_KEYinstead.The short-lived access token Garmin issues is cached in
~/.config/paceva-garmin/token.json, also readable only by you.The data your AI app reads is sent to that app's provider (for example Anthropic or OpenAI) as part of your chat, under their privacy terms.
To revoke access, delete the key in Garmin Connect.
Garmin's Personal API is for your own data. Each person uses their own key; please don't build a service that collects other people's keys.
Troubleshooting
"Garmin didn't accept your Personal API key": it expired or was deleted. Run
npx github:OwenScheuer/paceva-garmin-mcp --new-key. (For the Claude Desktop extension, update the key in Settings › Extensions.)"No Garmin Personal API key found": run
npx github:OwenScheuer/paceva-garmin-mcpin a terminal."Garmin is rate-limiting requests": wait a minute and ask again.
Development
npm install
npm test
npm run build
./scripts/pack-mcpb.sh # builds paceva-garmin.mcpbNot affiliated with or endorsed by Garmin. Garmin and Garmin Connect are trademarks of Garmin Ltd. or its subsidiaries.
MIT licensed. Made by Paceva.
Available Tools
18 toolsget_activityActivity detailsARead-onlyIdempotent
One activity in full: summary, laps or splits where available, and with include_workouts the structured workout it followed.
Inputs: activity_id (required), include_workouts.
get_body_batteryBody BatteryARead-onlyIdempotent
Garmin Body Battery per day: charged, drained, highest and lowest, for one day or a range.
Inputs: end_date, start_date, include_series.
get_daily_overviewDaily overviewARead-onlyIdempotent
One day from Garmin in one call: the daily summary (steps, resting heart rate, stress, calories, intensity minutes), the night's sleep, overnight HRV and Body Battery.
Inputs: date, include_series.
get_daily_summariesDaily summariesARead-onlyIdempotent
Daily totals for a range of days: steps, distance, calories, resting heart rate, stress, intensity minutes, floors. Up to 92 days per call.
Inputs: start_date (required), end_date.
get_fitness_ageFitness ageCRead-onlyIdempotent
Garmin's fitness age for a date.
Inputs: date.
get_food_logFood logBRead-onlyIdempotent
Foods logged in Garmin Connect for one day, with calories and macros.
Inputs: date.
get_heart_rateHeart rate (one day)ARead-onlyIdempotent
One day's heart rate: resting, minimum, maximum, the 7-day resting average, and (with include_series) the readings through the day.
Inputs: date, include_series.
get_hrvHeart rate variabilityARead-onlyIdempotent
Overnight HRV: for one night, the summary and readings; with an end_date, the nightly average, weekly average, baseline and status for each day in a range.
Inputs: end_date, start_date, include_series.
get_hydrationHydrationBRead-onlyIdempotent
Logged water intake against goal per day over a range.
Inputs: start_date (required), end_date.
get_menstrual_cycleMenstrual cycleCRead-onlyIdempotent
Cycle tracking for a date, if it's tracked in Garmin Connect.
Inputs: date.
get_profileProfile and zonesARead-onlyIdempotent
Profile settings from Garmin Connect (units, age, sex, height, weight and others) and heart rate zones.
Inputs: no named parameters.
get_sleepSleepARead-onlyIdempotent
Sleep for one night (stages, score, overnight heart rate, respiration) or, with an end_date, a nightly summary per day across a range. A night is filed under the date you woke up.
Inputs: end_date, start_date, include_series.
get_spo2Pulse OxARead-onlyIdempotent
Blood oxygen (SpO2) for one day, with altitude acclimation where the watch reports it.
Inputs: date, include_series.
get_stepsStepsBRead-onlyIdempotent
Steps, distance and step goal per day over a range.
Inputs: start_date (required), end_date.
get_stressStressBRead-onlyIdempotent
Average and maximum all-day stress per day over a range.
Inputs: start_date (required), end_date.
get_training_logTraining logARead-onlyIdempotent
Every activity in a period, with the main fields from Garmin's activity list under Garmin's own names and values: distance (m), duration (s), speed (m/s), grade-adjusted speed, elevation, heart rate, cadence, power and power curve (maxAvgPower_), TSS, intensity factor, training effect and load, fastest splits (fastestSplit_, in seconds) and seconds per heart rate and power zone. Up to 366 days per call.
Inputs: start_date (required), sport, end_date.
get_weightWeight and body compositionBRead-onlyIdempotent
Weigh-ins over a range, with body fat, muscle mass and BMI where a scale records them.
Inputs: start_date (required), end_date.
list_activitiesList activitiesARead-onlyIdempotent
Recorded activities, newest first: type, start time, duration, distance, heart rate, power, pace and training effect. Filter by date range or type (for example running, cycling, lap_swimming, strength_training). Use get_activity for one activity in full.
Inputs: limit, offset, end_date, start_date, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools target a single distinct Garmin metric (weight, HRV, SpO2, hydration, food log, menstrual cycle) and are easy to tell apart. The main overlap is between get_daily_overview (one-day bundle), get_daily_summaries (range totals), and the per-metric range tools like get_steps/get_stress; descriptions clarify the difference but an agent could still dither between overview and summaries. The activity trio (list_activities, get_training_log, get_activity) is also close, though the description passes the reader from list to detail.
Nearly everything follows a clean get_<noun> snake_case pattern, which makes the set highly predictable. The single list_activities deviates from the get_* convention, though 'list' is arguably semantically correct for a collection endpoint.
18 tools is on the heavy side but each maps to a real, non-redundant Garmin metric or resource. Nothing feels padded, though a couple of range tools could conceivably be folded into the summary tools.
Coverage of Garmin health data is broad: profile/zones, sleep, HRV, Body Battery, stress, steps, heart rate, SpO2, activities, training log, hydration, food and cycle tracking. Gaps exist around derived training metrics (VO2 max, training status/readiness, personal records) and device management, but the core read-only surface is largely complete.
Related MCP Connectors
Read-only Apple Health data synced from your iPhone: sleep, heart rate, HRV, workouts and trends.
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Read wearables and lab health data — sleep, activity, workouts, timeseries, lab tests and orders.
Ask Claude, ChatGPT or Cursor about your Apple Health data: workouts, sleep, food. Read-only.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables Claude to access and query your Garmin Connect data, including sleep, activities, training load, and health metrics, through a set of read-only MCP tools.28199 PyPI5MIT
- AlicenseAqualityBmaintenanceEnables local, read-only access to Garmin Connect health and training data through MCP, letting assistants summarize recovery, sleep, activities, and more without uploading your data.27MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to Garmin Connect health and activity data, including daily summaries, sleep, heart rate, stress, Body Battery, HRV, training readiness, activities, and devices.MIT
- AlicenseAqualityBmaintenanceGarmin Connect for Claude and any MCP client, on Garmin's official Personal API. Read-only access to sleep, HRV, Body Battery, stress, heart rate, activities and weight with a revocable key, no password or scraping.261,568 PyPI69MIT