Skip to content
Back to search

claude-garmin-mcp

MarketplaceWorks with Claude CodeGitHub

Talk to your own Garmin data in Claude. A free, private MCP server on Cloudflare Workers using Garmin's official Personal API

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/yershalom/claude-garmin-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/yershalom/claude-garmin-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yershalom--claude-garmin-mcp/badge.svg)](/listings/yershalom--claude-garmin-mcp)

HTML

<a href="/listings/yershalom--claude-garmin-mcp"><img src="/api/listings/yershalom--claude-garmin-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "claude-garmin-mcp",
  3. "owner": { "name": "yershalom" },
  4. "plugins": [
  5. {
  6. "name": "garmin-health-coach",
  7. "source": "./",
  8. "description": "Coaching-style answers about your own Garmin data (sleep, workouts, recovery) using the Garmin MCP connector."
  9. }
  10. ]
  11. }
README.md · README · 152 lines
  1. # Garmin MCP for Claude
  2. Talk to your own Garmin data in Claude: *"How did I sleep this week?"*, *"Did my walks hit my
  3. heart-rate target?"*, *"Show the sets I logged at the gym yesterday."*
  4. A small, private [MCP](https://modelcontextprotocol.io) server on Cloudflare Workers that uses
  5. Garmin's official, read-only [Connect Personal API](https://developer.garmin.com/gc-developer-program/personal/personal-api/).
  6. It costs nothing to run for one person.
  7. 📖 **Full write-up:** [Talk to your Garmin data in Claude, for free](https://blog.yershalom.com/posts/garmin-mcp-claude/) (also on [dev.to](https://dev.to/yershalom/talk-to-your-garmin-data-in-claude-for-free-1928))
  8. [![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/yershalom/claude-garmin-mcp)
  9. ## How it works
  10. ```
  11. Claude ──OAuth (GitHub sign-in, only you)──▶ Worker /mcp ──Bearer token──▶ Garmin Personal API
  12. │
  13. └─ KV: OAuth grants + cached Garmin token
  14. ```
  15. - Your Garmin **personal API key** is a Worker secret. The Worker swaps it for a 24-hour access
  16. token, caches it in KV, and refreshes it an hour before it expires.
  17. - **`/mcp` is locked.** Claude has to sign in through OAuth, which sends you to GitHub, and only the
  18. GitHub account in `ALLOWED_GITHUB_LOGIN` gets through.
  19. - **Read-only.** Every tool is a `GET`. Names, profile photos and GPS coordinates are stripped from
  20. responses before they reach Claude.
  21. ## What it costs
  22. | Piece | Cost |
  23. |---|---|
  24. | Garmin Connect Personal API | Free |
  25. | Cloudflare Workers, Free plan (100,000 requests/day) | Free |
  26. | Workers KV, Free plan (100,000 reads, 1,000 writes/day) | Free. This server writes about once a day |
  27. | GitHub OAuth app | Free |
  28. | Claude | Works on the Free plan, which allows one custom connector |
  29. | Custom domain | Optional, about $10/year. The free `*.workers.dev` address works fine |
  30. | **Total** | **$0** |
  31. ## Tools
  32. | Tool | Data |
  33. |---|---|
  34. | `get_daily_summaries` | Steps, calories, intensity minutes, resting HR, stress, Body Battery per day |
  35. | `get_daily_steps`, `get_daily_stress`, `get_hydration` | Per-day stats |
  36. | `get_sleep_summaries`, `get_sleep_detail` | Sleep per night, or one night in detail |
  37. | `get_daily_heart_rate`, `get_hrv_summaries`, `get_spo2` | Heart rate, HRV, blood oxygen |
  38. | `get_body_battery`, `get_vo2_max`, `get_fitness_age` | Recovery and fitness |
  39. | `get_weight` | Weight and body composition |
  40. | `search_activities`, `get_activity`, `get_activity_workouts`, `list_activity_types` | Workouts, including strength sets and reps |
  41. | `get_heart_rate_zones`, `get_profile_settings` | Settings |
  42. ## Set it up (about 15 minutes, all in the browser)
  43. ### 1. Garmin API key
  44. Open the [Personal API Key page](https://connect.garmin.com/app/settings/personalApiToken) in Garmin Connect (sign in on the web if asked) →
  45. **Create Key** → accept the terms → pick an expiry → **Create**. Copy the key: it's shown once.
  46. Garmin's own guide: [Garmin Connect Personal API](https://developer.garmin.com/gc-developer-program/personal/personal-api/).
  47. ### 2. Deploy
  48. Click **Deploy to Cloudflare** above. It forks this repo into your GitHub, creates the KV
  49. namespace and deploys the Worker. Note the Worker's address, for example
  50. `https://garmin-mcp.<your-subdomain>.workers.dev`.
  51. Prefer doing it by hand? Fork the repo, then in Cloudflare go to **Workers & Pages → Create →
  52. Import a repository**, pick your fork, and set the deploy command to `npx wrangler deploy`.
  53. ### 3. Set your two variables
  54. In your fork, edit `wrangler.jsonc`:
  55. - `ALLOWED_GITHUB_LOGIN`: your GitHub username
  56. - `PUBLIC_URL`: the Worker address from step 2
  57. Commit. Cloudflare redeploys on every push.
  58. ### 4. GitHub OAuth app
  59. GitHub → **Settings → Developer settings → OAuth Apps → New OAuth App**:
  60. - Homepage URL: your Worker address
  61. - Authorization callback URL: your Worker address + `/callback`
  62. - Leave wildcard matching and device flow off
  63. Copy the **Client ID**, and generate a **Client secret**.
  64. ### 5. Secrets
  65. Cloudflare → your Worker → **Settings → Variables and Secrets → Add**, type **Secret**:
  66. | Name | Value |
  67. |---|---|
  68. | `GARMIN_API_KEY` | from step 1 |
  69. | `GITHUB_CLIENT_ID` | from step 4 |
  70. | `GITHUB_CLIENT_SECRET` | from step 4 |
  71. ### 6. Connect Claude
  72. [claude.ai/customize/connectors](https://claude.ai/customize/connectors) → **Add custom
  73. connector** → URL: your Worker address + `/mcp` → **Connect** → approve → sign in with GitHub.
  74. Start a new chat and ask: *"Summarise my last 7 days from Garmin."*
  75. ### Check it's locked
  76. ```bash
  77. curl -s -o /dev/null -w '%{http_code}\n' -X POST https://YOUR-WORKER/mcp # must print 401
  78. ```
  79. ## Optional: the coach skill
  80. [`skills/garmin-health-coach/SKILL.md`](skills/garmin-health-coach/SKILL.md) teaches the agent *how* to
  81. use these tools: which ones answer which question, how to read recovery signals together, and how to
  82. answer like a coach rather than dumping JSON. It's free, like everything else here.
  83. - **claude.ai:** download [`dist/garmin-health-coach-plugin.zip`](dist/garmin-health-coach-plugin.zip)
  84. (click **Download raw file**), then Settings → Plugins → **Add → Upload plugin** and pick the zip.
  85. - **Claude Code:** add this repo as a plugin marketplace and install it:
  86. ```
  87. /plugin marketplace add yershalom/claude-garmin-mcp
  88. /plugin install garmin-health-coach@claude-garmin-mcp
  89. ```
  90. Or copy `skills/garmin-health-coach` into `~/.claude/skills/`.
  91. - **Other agents** that read `SKILL.md` files: put the folder wherever that agent loads skills from.
  92. Then try: *"Should I train hard today?"* or *"Compare this week's sleep with last week's."*
  93. ## Local development
  94. ```bash
  95. npm install
  96. cp .dev.vars.example .dev.vars # fill in your key, a local GitHub OAuth app, your username
  97. npm run check-garmin # tests your Garmin key directly, no server needed
  98. npm run dev # http://localhost:8787
  99. ```
  100. For the local GitHub OAuth app, use the callback `http://localhost:8787/callback`. To try the tools,
  101. run `npx @modelcontextprotocol/inspector` and connect to `http://localhost:8787/mcp`.
  102. Claude itself can't reach `localhost`, so deploy before connecting Claude.
  103. `npm run typecheck` checks the TypeScript.
  104. ## Security notes
  105. - Secrets live only in Cloudflare (or your git-ignored `.dev.vars`). None are in the repo.
  106. - To cut off access, remove the connector in Claude, delete the key in Garmin Connect, or both.
  107. - The Garmin key expires on the date you picked. Make a new one and update `GARMIN_API_KEY`. The
  108. cached token is tied to the key, so it refreshes by itself.
  109. - The Personal API is for your own data. Each person runs their own copy with their own key.
  110. ## Credits
  111. Endpoint list and auth flow from Garmin's official
  112. [connect-personal-api-python](https://github.com/garmin/connect-personal-api-python) client.
  113. Built with [workers-oauth-provider](https://github.com/cloudflare/workers-oauth-provider) and the
  114. [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk).
  115. MIT licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.