yershalom

Talk to your Garmin data in Claude, for free

November 2026 · 10 min read

I wanted to get healthier, and I wanted a coach I could ask "how did this week actually go?" without scrolling through five screens of the Garmin app. So I connected my watch to Claude. Here's what I built, what it taught me about my own habits, and how you can set up your own copy in about 15 minutes for $0.

What I wanted

My plan was simple: two long walks and two gym sessions a week, more sleep, and steady progress instead of big heroic weeks followed by nothing. The data was already on my wrist. What I didn't have was an easy way to ask questions of it:

Claude can answer those questions in plain language, if it can read the data. That's what an MCP server is for: a small service that gives Claude a set of tools, like "get my sleep for these dates", that it can call when you ask something.

What I got out of it

A week in, these were the useful bits. None of them needed a dashboard, only a question:

How it works

Claudeasks a question Your Worker/mcp · Cloudflare GarminPersonal API OAuth token Bearer token KVgrants + cached token signs in once withGitHub (only you)
Claude never sees your Garmin key. The Worker holds it and only answers Claude after you've signed in.

What it costs: nothing

PieceCost
Garmin Connect Personal APIFree
Cloudflare Workers, Free plan (100,000 requests a day)Free
Workers KV, Free plan (100,000 reads, 1,000 writes a day)Free. The server writes about once a day
GitHub OAuth appFree
ClaudeWorks on the Free plan, which allows one custom connector
Custom domainOptional, about $10 a year. The free workers.dev address is fine
Total$0

One person asking a few questions a day uses a tiny fraction of those limits.

Build your own

Everything is in a public template. You don't need to write any code, and every step happens in a browser.

Get the template on GitHub →

1. Create a Garmin personal API key

Open the Personal API Key page in Garmin Connect (sign in on the web if asked), then Create Key → accept the terms → choose an expiry → Create. Copy it somewhere safe: Garmin only shows it once. Garmin's own walkthrough is in the Personal API docs.

2. Deploy the Worker

Click Deploy to Cloudflare in the template's README. It forks the repo into your GitHub account, creates the KV storage and deploys. Note your Worker's address, something like https://garmin-mcp.<you>.workers.dev.

3. Tell it who you are

In your fork, edit wrangler.jsonc. Set ALLOWED_GITHUB_LOGIN to your GitHub username and PUBLIC_URL to the Worker address, then commit. Cloudflare redeploys automatically.

4. Make a GitHub OAuth app

GitHub → Settings → Developer settings → OAuth Apps → New OAuth App. Use your Worker address as the homepage and <worker address>/callback as the callback URL. Leave wildcard matching and device flow off. Copy the Client ID and generate a Client secret.

5. Add three secrets

Cloudflare → your Worker → Settings → Variables and Secrets. Add these, each as type Secret:

NameValue
GARMIN_API_KEYyour key from step 1
GITHUB_CLIENT_IDfrom step 4
GITHUB_CLIENT_SECRETfrom step 4

6. Connect Claude

Go to claude.ai → Customize → Connectors → Add custom connector, and paste <worker address>/mcp. Click Connect, approve, and sign in with GitHub. Start a new chat and try:

Summarise my last 7 days from Garmin: sleep, steps, workouts and recovery.
Check the lock. A request without a token must be refused: curl -s -o /dev/null -w '%{http_code}' -X POST https://<worker>/mcp should print 401.

Want to hack on it?

The repo includes a .dev.vars.example, so local setup takes three commands:

cp .dev.vars.example .dev.vars   # add your key and a local GitHub OAuth app
npm run check-garmin             # tests your Garmin key directly, no server needed
npm run dev                      # runs at http://localhost:8787

Point the MCP Inspector at http://localhost:8787/mcp to try the tools. Claude connects from the cloud and can't reach localhost, so deploy before connecting it.

Things I learned along the way

Credits

The endpoint list and auth flow come from Garmin's official connect-personal-api-python client and the Personal API docs. The server is built on Cloudflare's workers-oauth-provider and the MCP TypeScript SDK.

This isn't medical advice. Check a new training plan with your doctor, especially if you have a health condition.