Garmin → Claude · Self-Hosted MCP Server + Live Dashboard

Put your Garmin Connect data inside Claude — and run your own private health & triathlon dashboard — on a small server that's entirely yours.

• 🗣️ Ask your body data in plain English in Claude (web, desktop, mobile): "How did I sleep?", "Show my last 5 runs", "Am I recovered for a hard session?"

• 📊 A live dashboard at /dashboard — body battery, sleep, heart rate, stress, VO₂ max, training load, HR zones, weight/hydration, and a Swim / Bike / Run view that fills in as you train.

• 🔒 Private by design — runs on your Railway account, locked with your bearer token. Your Garmin password never leaves your own computer.

Built for the community by Sudhakar Reddy Gade · 📖 Full step-by-step guide (no coding needed): https://www.nirvedha.com/garmin-dashboard/

Quick start

The easy way — let Claude Code do it

Install Claude Code, open it in an empty folder, and paste the ready-made prompt from the guide. It clones this repo, mints your Garmin token, deploys to Railway, and hands you your connector + dashboard URLs. You only approve the Railway login and type your Garmin password into your own terminal.

The hands-on way

Fork this repo and follow the guide (8 clicks-and-copy steps, ~20 minutes) or the concise SETUP.md. In short: fork → deploy on Railway → add a volume at /root/.garminconnect → set four variables → generate a domain → add to Claude.

Related MCP server: Garmin MCP Server

What you get

Environment variables

See SETUP.md for the full list, token rotation, and re-auth.

Security model

• Fail-closed: the server refuses to start without a strong MCP_ACCESS_TOKEN, so the endpoint is never exposed unprotected — not even briefly.

• The bearer check runs before the MCP app, so unauthorized callers get 401 and never reach your data.

• Your Garmin password is only ever used locally to mint a token blob; the deployed server uses the blob (read-scoped OAuth tokens), never the password.

• .gitignore keeps .env, tokens, and caches out of git.

Architecture

Claude (web / desktop / mobile)  ──HTTPS + bearer token──►  Railway service
                                                                 │
                    BearerAuthMiddleware ──► /healthz (open) · /mcp · /dashboard
                                                                 │
                                             FastMCP (90+ tools) + dashboard API
                                                                 │
                                             garminconnect + garth ──► Garmin API
                                             (OAuth tokens on a persistent volume)

Local development

uv sync
# stdio (for Claude Desktop config):
GARMIN_MCP_TRANSPORT=stdio uv run garmin-mcp
# streamable HTTP + dashboard:
MCP_ACCESS_TOKEN=$(python3 -c "import secrets;print(secrets.token_urlsafe(32))") \
GARMIN_MCP_TRANSPORT=streamable-http uv run garmin-mcp-http
# mint a Garmin token blob (interactive):
uv run garmin-mcp-mint

Credits

Stands on the shoulders of the open-source garmin_mcp by Taxuspt and the Docker + streamable-HTTP fork by k8sautom8. This repo adds a bearer-token security layer, $PORT/proxy fixes, and the live triathlon dashboard.

License

MIT — free to use, change, and share. See LICENSE.

Shared as a community resource by Nirvedha Executive Coaching Solutions, Hyderabad · https://nirvedha.com