Garmin MCP
Provides read-only access to Garmin Connect health and fitness data, including daily summaries, steps, stress, hydration, sleep, heart rate, HRV, SpO2, Body Battery, VO2 max, fitness age, weight, activities, workouts, heart-rate zones, and profile settings.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Garmin MCP for Claude
Talk to your own Garmin data in Claude: "How did I sleep this week?", "Did my walks hit my heart-rate target?", "Show the sets I logged at the gym yesterday."
A small, private MCP server on Cloudflare Workers that uses Garmin's official, read-only Connect Personal API. It costs nothing to run for one person.
📖 Full write-up: Talk to your Garmin data in Claude, for free (also on dev.to)
How it works
Claude ──OAuth (GitHub sign-in, only you)──▶ Worker /mcp ──Bearer token──▶ Garmin Personal API
│
└─ KV: OAuth grants + cached Garmin tokenYour Garmin personal API key is a Worker secret. The Worker swaps it for a 24-hour access token, caches it in KV, and refreshes it an hour before it expires.
/mcpis locked. Claude has to sign in through OAuth, which sends you to GitHub, and only the GitHub account inALLOWED_GITHUB_LOGINgets through.Read-only. Every tool is a
GET. Names, profile photos and GPS coordinates are stripped from responses before they reach Claude.
Related MCP server: garmin-mcp
What it costs
Piece | Cost |
Garmin Connect Personal API | Free |
Cloudflare Workers, Free plan (100,000 requests/day) | Free |
Workers KV, Free plan (100,000 reads, 1,000 writes/day) | Free. This server writes about once a day |
GitHub OAuth app | Free |
Claude | Works on the Free plan, which allows one custom connector |
Custom domain | Optional, about $10/year. The free |
Total | $0 |
Tools
Tool | Data |
| Steps, calories, intensity minutes, resting HR, stress, Body Battery per day |
| Per-day stats |
| Sleep per night, or one night in detail |
| Heart rate, HRV, blood oxygen |
| Recovery and fitness |
| Weight and body composition |
| Workouts, including strength sets and reps |
| Settings |
Date-range tools accept up to a year. Garmin's API only allows 28 days per request, so the server splits longer ranges into 28-day requests and merges the results.
Set it up (about 15 minutes, all in the browser)
1. Garmin API key
Open the Personal API Key page in Garmin Connect (sign in on the web if asked) → Create Key → accept the terms → pick an expiry → Create. Copy the key: it's shown once. Garmin's own guide: Garmin Connect Personal API.
2. Deploy
Click Deploy to Cloudflare above. It forks this repo into your GitHub, creates the KV
namespace and deploys the Worker. Note the Worker's address, for example
https://garmin-mcp.<your-subdomain>.workers.dev.
Prefer doing it by hand? Fork the repo, then in Cloudflare go to Workers & Pages → Create →
Import a repository, pick your fork, and set the deploy command to npx wrangler deploy.
3. Set your two variables
In your fork, edit wrangler.jsonc:
ALLOWED_GITHUB_LOGIN: your GitHub usernamePUBLIC_URL: the Worker address from step 2
Commit. Cloudflare redeploys on every push.
4. GitHub OAuth app
GitHub → Settings → Developer settings → OAuth Apps → New OAuth App:
Homepage URL: your Worker address
Authorization callback URL: your Worker address +
/callbackLeave wildcard matching and device flow off
Copy the Client ID, and generate a Client secret.
5. Secrets
Cloudflare → your Worker → Settings → Variables and Secrets → Add, type Secret:
Name | Value |
| from step 1 |
| from step 4 |
| from step 4 |
6. Connect Claude
claude.ai/customize/connectors → Add custom
connector → URL: your Worker address + /mcp → Connect → approve → sign in with GitHub.
Start a new chat and ask: "Summarise my last 7 days from Garmin."
Check it's locked
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://YOUR-WORKER/mcp # must print 401Optional: the coach skill
skills/garmin-health-coach/SKILL.md teaches the agent how to
use these tools: which ones answer which question, how to read recovery signals together, and how to
answer like a coach rather than dumping JSON. It's free, like everything else here.
claude.ai: download
dist/garmin-health-coach-plugin.zip(click Download raw file), then Settings → Plugins → Add → Upload plugin and pick the zip.Claude Code: add this repo as a plugin marketplace and install it:
/plugin marketplace add yershalom/claude-garmin-mcp /plugin install garmin-health-coach@claude-garmin-mcpOr copy
skills/garmin-health-coachinto~/.claude/skills/.Other agents that read
SKILL.mdfiles: put the folder wherever that agent loads skills from.
Then try: "Should I train hard today?" or "Compare this week's sleep with last week's."
Local development
npm install
cp .dev.vars.example .dev.vars # fill in your key, a local GitHub OAuth app, your username
npm run check-garmin # tests your Garmin key directly, no server needed
npm run dev # http://localhost:8787For the local GitHub OAuth app, use the callback http://localhost:8787/callback. To try the tools,
run npx @modelcontextprotocol/inspector and connect to http://localhost:8787/mcp.
Claude itself can't reach localhost, so deploy before connecting Claude.
npm run typecheck checks the TypeScript.
Security notes
Secrets live only in Cloudflare (or your git-ignored
.dev.vars). None are in the repo.To cut off access, remove the connector in Claude, delete the key in Garmin Connect, or both.
The Garmin key expires on the date you picked. Make a new one and update
GARMIN_API_KEY. The cached token is tied to the key, so it refreshes by itself.The Personal API is for your own data. Each person runs their own copy with their own key.
Credits
Endpoint list and auth flow from Garmin's official connect-personal-api-python client. Built with workers-oauth-provider and the MCP TypeScript SDK.
MIT licensed.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
WHOOP recovery, strain, sleep and workouts in Claude via official WHOOP OAuth. Free, open source.
tri-train is a training platform for triathletes that syncs activities from Strava and Garmin and exposes them to Claude through a remote MCP server. Ask Claude how your last block went, why your run pace dropped, or whether you are fresh enough for Sunday's race, and it answers from your real data: activities with laps and grade-adjusted pace, weekly load and the performance management chart (CTL/ATL/TSB), sleep, HRV and resting heart rate, and your race calendar with predictions. Claude can also act: create and adjust planned workouts with structured intervals, push them to your Garmin watch, add races and write notes. Every change is journaled and can be undone. Read and write access are separate OAuth scopes, and the server enforces them on every call. Built and hosted in Switzerland by a triathlete; data stays on our own servers (Swiss revDSG / GDPR).
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables Claude to access and query your Garmin Connect data—sleep, training, heart rate, and more—through a suite of read-only tools, with an optional write path for creating strength workouts.63MIT
- AlicenseBqualityBmaintenanceConnects Claude to a personal Garmin Connect account so users can ask natural-language questions about sleep, HRV, body battery, stress, heart rate, training readiness and activities, and optionally create or schedule workouts and log weigh-ins. Reads are returned as trimmed summaries with optional full JSON, and writes stay disabled unless explicitly enabled.24MIT
- AlicenseAqualityBmaintenanceEnables Claude to read your own Garmin Connect data—activities and exact pace splits, VO2 max and training effect, sleep, HRV, Body Battery, stress, weight and more—through Garmin's official Personal API, with no password or scraping. Access is read-only and runs entirely on your machine, so you can ask natural-language questions about training and recovery.23115 npm1MIT
- AlicenseNot gradedqualityNot gradedmaintenanceA read-only remote server that lets Claude query your own Garmin Connect account through Garmin's official Personal API, with OAuth sign-in so it works in the mobile app as well as on desktop. It exposes sleep, HRV, recovery, Body Battery, stress, heart rate and activity tools for natural-language questions like "should I train hard today?" or "compare my last three long runs."MIT