Skip to main content
Glama
Paceva for Garmin

Paceva for Garmin

by OwenScheuer

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

  1. Download paceva-garmin.mcpb and open it.

  2. Claude asks for your Garmin key: open Garmin Connect › Personal API Key, select Create Key, copy it, paste it in.

  3. Switch Paceva for Garmin on. Claude installs extensions switched off.

  4. 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-mcp

It 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

get_daily_overview

One day at a glance: summary, sleep, HRV and Body Battery

get_daily_summaries

Steps, calories, resting HR, stress and intensity minutes per day

get_sleep

One night in detail, or nightly summaries over a range

get_hrv

Overnight HRV, baseline and status

get_body_battery

Charged, drained, high and low

get_stress · get_steps · get_heart_rate · get_spo2

Daily stress, steps, heart rate and Pulse Ox

get_training_log

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

list_activities · get_activity

Your activities, and any one in full

get_profile

Profile settings and heart rate zones

get_weight · get_fitness_age · get_hydration · get_food_log · get_menstrual_cycle

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 set GARMIN_PERSONAL_API_KEY instead.

  • 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-mcp in 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.mcpb

Not 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 tools
get_activityActivity detailsA
Read-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 BatteryA
Read-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 overviewA
Read-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 summariesA
Read-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 ageC
Read-onlyIdempotent

Garmin's fitness age for a date.

Inputs: date.

get_food_logFood logB
Read-onlyIdempotent

Foods logged in Garmin Connect for one day, with calories and macros.

Inputs: date.

get_heart_rateHeart rate (one day)A
Read-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 variabilityA
Read-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_hydrationHydrationB
Read-onlyIdempotent

Logged water intake against goal per day over a range.

Inputs: start_date (required), end_date.

get_menstrual_cycleMenstrual cycleC
Read-onlyIdempotent

Cycle tracking for a date, if it's tracked in Garmin Connect.

Inputs: date.

get_profileProfile and zonesA
Read-onlyIdempotent

Profile settings from Garmin Connect (units, age, sex, height, weight and others) and heart rate zones.

Inputs: no named parameters.

get_sleepSleepA
Read-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 OxA
Read-onlyIdempotent

Blood oxygen (SpO2) for one day, with altitude acclimation where the watch reports it.

Inputs: date, include_series.

get_stepsStepsB
Read-onlyIdempotent

Steps, distance and step goal per day over a range.

Inputs: start_date (required), end_date.

get_stressStressB
Read-onlyIdempotent

Average and maximum all-day stress per day over a range.

Inputs: start_date (required), end_date.

get_training_logTraining logA
Read-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 compositionB
Read-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 activitiesA
Read-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

    B3.4/5.0

    Scored across 18 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      28
      199 PyPI
      5
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      27
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Garmin 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.
      26
      1,568 PyPI
      69
      MIT