Garmin MCP

<!-- delx-wellness header v2 --> <h1 align="center">Garmin MCP</h1>

<div align="center"> <img src="assets/banner.png" alt="Garmin MCP — Garmin MCP for AI agents" width="85%" /> </div>

<h3 align="center"> Give your AI agent your Garmin Body Battery, training readiness, sleep, HRV and activities.<br> Local-first MCP server — <strong>tokens never leave your machine</strong>. </h3>

<p align="center"> <a href="https://www.npmjs.com/package/garmin-mcp-unofficial"><img src="https://img.shields.io/npm/v/garmin-mcp-unofficial?style=for-the-badge&labelColor=0F172A&color=10B981&logo=npm&logoColor=white" alt="npm version" /></a> <a href="https://www.npmjs.com/package/garmin-mcp-unofficial"><img src="https://img.shields.io/npm/dm/garmin-mcp-unofficial?style=for-the-badge&labelColor=0F172A&color=0EA5A3&logo=npm&logoColor=white" alt="npm downloads" /></a> <a href="LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge&labelColor=0F172A" alt="License MIT" /></a> <a href="https://wellness.delx.ai/connectors/garmin"><img src="https://img.shields.io/badge/SITE-wellness.delx.ai-0EA5A3?style=for-the-badge&labelColor=0F172A" alt="Site" /></a> </p>

<p align="center"> <a href="https://github.com/davidmosiah/garmin-mcp/stargazers"><img src="https://img.shields.io/github/stars/davidmosiah/garmin-mcp?style=for-the-badge&labelColor=0F172A&color=FBBF24&logo=github" alt="GitHub stars" /></a> <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge&labelColor=0F172A" alt="Built for MCP" /></a> <a href="https://github.com/davidmosiah/delx-wellness-hermes"><img src="https://img.shields.io/badge/HERMES-one--command_setup-10B981?style=for-the-badge&labelColor=0F172A" alt="Hermes one-command setup" /></a> <a href="https://github.com/davidmosiah/delx-wellness"><img src="https://img.shields.io/badge/Garmin-007CC3?style=for-the-badge&labelColor=0F172A&logoColor=white&logo=garmin&logoColor=white" alt="Garmin" /></a> </p>

⚡ One-command install with Delx Wellness for Hermes: npx -y delx-wellness-hermes setup — preconfigures this connector and the full Delx Wellness stack in a dedicated Hermes profile.

Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop — see the install section below. Runnable examples live in the Delx Agent Workbench.

---

<!-- /delx-wellness header v2 -->

Local-first MCP server that connects AI agents to your Garmin sleep, HRV, Body Battery, stress, training readiness and activities.

Unofficial project. Not affiliated with, endorsed by or supported by Garmin. This is not official Garmin Health API partnership access — it uses the unofficial Garmin Connect personal-token mode.

Built by David Mosiah for people who use Claude, Cursor, Hermes, OpenClaw or other MCP-compatible agents to think about training, sleep and recovery — without copy-pasting numbers from the Garmin Connect app.

Part of Delx Wellness, a registry of local-first wellness MCP connectors.

If this connector helps your agent workflow, please star the repo. Stars make the project easier for other AI builders to discover and help Delx keep shipping local-first wellness infrastructure.

<p align="center"> <img src="assets/garmin-agent-demo.svg" alt="Garmin MCP local-first agent workflow demo" width="92%" /> </p>

Why this exists

Garmin produces some of the best processed wellness signals — sleep stages, HRV status, Body Battery, stress, training readiness, training status, intensity minutes — but its official Garmin Health API is partner-licensed and not self-serve for individuals.

This package gives individual Garmin users a practical bridge: it logs into Garmin Connect with your own credentials locally (never sent to any agent), keeps tokens on your machine, and exposes Garmin signals through the Model Context Protocol. Your password never reaches the MCP — only short-lived Garmin Connect tokens are stored.

Setup in 60 seconds

No Garmin developer app is required. setup only writes local MCP configuration; it does not ask for your Garmin password.

npx -y garmin-mcp-unofficial setup            # writes local config
npx -y garmin-mcp-unofficial auth             # built-in login, prompts for credentials locally (no Python needed)
npx -y garmin-mcp-unofficial doctor           # verifies you're ready

Or one shot:

npx -y garmin-mcp-unofficial setup --auth

auth runs a self-contained Node login and prompts locally for Garmin email, password and MFA when needed. The MCP does not store your Garmin password — only Garmin Connect tokens, saved at ~/.garmin-mcp/garmin_tokens.json with user-only permissions.

📺 Want to see exactly what each command prints? The auth quickstart walkthrough shows real --help, auth, auth --json and doctor output for the full first-call journey.

Prefer the old Python flow? auth --use-python (or auth --install-helper to install the garminconnect package, with an isolated virtualenv fallback under ~/.garmin-mcp/venv) still works.

Then add this to your MCP client config:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "garmin-mcp-unofficial"]
    }
  }
}

Try it with your agent

Three things to ask first:

Use garmin_connection_status to check setup, then run garmin_daily_summary.
Give me a 5-line operating brief for today.

Call garmin_weekly_summary with response_format=json. Identify my biggest
recovery/sleep/stress bottleneck and give me a next-week plan.

Use the garmin_intraday_investigation prompt for date=today, focus=stress.
Don't claim Garmin can prove anything it can't.

Data availability

This package reads processed Garmin Connect data via the unofficial personal-token mode. When this README says raw, it means upstream Garmin Connect JSON — not raw accelerometer / gyroscope / continuous device telemetry.

Data	Available	Notes
Sleep duration + stages + score	✓	When the device/account supports it
HRV status + overnight HRV	✓	When supported by device/account
Body Battery (daily + events)	✓	Charge/drain reports
Stress samples + daily summary	✓	Per-day stress context
Training readiness + training status	✓	When supported by device/account
Daily movement (steps, calories, distance, floors, intensity minutes)	✓	Standard wellness signals
Heart rate (resting + daily samples)	✓	Per-day samples and resting HR
Activities + details + splits + zones	✓	Recent activities and detail payloads
Body composition / weight + hydration	✓	When logged
Continuous device telemetry / accelerometer / gyroscope	—	Not exposed by Garmin Connect web endpoints

Garmin can change private auth or endpoints at any time. Failures should be treated as integration drift, not user error.

Tools

Start with these:

• garmin_connection_status — verify local setup before calling Garmin Connect
• garmin_data_inventory — inventory supported data domains, scopes, privacy modes and recommended first calls without calling Garmin APIs.
• garmin_daily_summary — daily readiness, sleep, load, action candidates
• garmin_weekly_summary — scorecard, bottlenecks, next-week plan

Auth & diagnostics

• garmin_capabilities, garmin_agent_manifest, garmin_auth_instructions, garmin_privacy_audit

Profile & devices

• garmin_get_profile, garmin_get_user_settings
• garmin_list_devices, garmin_get_primary_training_device

Daily wellness signals (each takes a date)

• garmin_get_daily_summary, garmin_get_steps_day
• garmin_get_sleep_day, garmin_get_heart_day, garmin_get_hrv_day
• garmin_get_stress_day, garmin_get_body_battery_day, garmin_get_body_battery_events
• garmin_get_training_readiness_day, garmin_get_training_status_day
• garmin_get_respiration_day, garmin_get_spo2_day
• garmin_get_intensity_minutes_day, garmin_get_hydration_day

Activities

• garmin_list_activities, garmin_get_activity_details

Body & weight

• garmin_get_weight_range

Prompts

• garmin_daily_checkin — practical daily health and training check-in
• garmin_weekly_review — review trends across activity, sleep, stress, Body Battery, heart
• garmin_intraday_investigation — investigate one day's signals (heart, stress, Body Battery, activity)

Resources

• garmin://capabilities, garmin://agent-manifest
• garmin://summary/daily, garmin://summary/weekly

Privacy & security

• Garmin Connect tokens are stored at ~/.garmin-mcp/garmin_tokens.json with user-only permissions and are never returned by tools.
• Your Garmin password is never stored — only short-lived Garmin Connect tokens persist locally.
• GARMIN_PRIVACY_MODE defaults to summary (more conservative than other Delx Wellness connectors) because the auth model is unofficial.
• Local cache is opt-in via GARMIN_CACHE=sqlite.
• The MCP client never sees Garmin credentials or tokens.
• This is not medical advice. The server exposes user-authorized data for personal AI workflows, not diagnosis or treatment.

Configuration

GARMIN_TOKEN_PATH=~/.garmin-mcp/garmin_tokens.json
GARMIN_PRIVACY_MODE=summary                  # summary | structured | raw
GARMIN_CACHE=sqlite                          # optional read-through cache
GARMIN_CACHE_PATH=~/.garmin-mcp/cache.sqlite
GARMIN_DOMAIN=garmin.com                     # or garmin.cn for China accounts

Hermes / remote setup

npx -y garmin-mcp-unofficial setup --client hermes
npx -y garmin-mcp-unofficial auth
npx -y garmin-mcp-unofficial doctor --client hermes
hermes mcp test garmin

After Hermes config changes, use /reload-mcp or hermes mcp test garmin. Don't restart the gateway for normal data access.

Human-to-agent handoff

Paste this into your agent when you want it to install the bridge for you:

Install the unofficial Garmin MCP server for me.
Repository: https://github.com/davidmosiah/garmin-mcp
Run setup, then auth, then doctor.
If this is Hermes, use setup --client hermes and reload MCP with /reload-mcp or hermes mcp test garmin.
Never ask me to paste Garmin passwords, tokens or raw private payloads into chat.
Start with garmin_connection_status, then garmin_daily_summary.
This is not medical advice.

Requirements

• Node.js 20+
• A Garmin Connect account with active devices
• Python 3 only if you opt into the legacy auth --use-python helper; the default auth login is pure Node

Development

git clone https://github.com/davidmosiah/garmin-mcp.git
cd garmin-mcp
npm install
npm test
npm run build

Test with MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Links

• npm: https://www.npmjs.com/package/garmin-mcp-unofficial
• Docs site: https://wellness.delx.ai/connectors/garmin
• Legacy docs: https://garminconnectmcp.vercel.app/
• GitHub: https://github.com/davidmosiah/garmin-mcp
• Delx Wellness registry: https://github.com/davidmosiah/delx-wellness
• Connector quality standard: https://github.com/davidmosiah/delx-wellness/blob/main/docs/connector-quality-standard.md
• Garmin Health API program (official, partner-licensed): https://developer.garmin.com/gc-developer-program/health-api/

<!-- delx-wellness see-also -->

See also

The full Delx Wellness connector library:

Provider	Package	Repo
WHOOP	whoop-mcp-unofficial	whoop-mcp
Oura	oura-mcp-unofficial	ouramcp
Garmin	garmin-mcp-unofficial	garmin-mcp
Strava	strava-mcp-unofficial	strava-mcp
Fitbit	fitbit-mcp-unofficial	fitbitmcp
Withings	withings-mcp-unofficial	withingsmcp
Apple Health	apple-health-mcp-unofficial	apple-health-mcp
Polar	polar-mcp-unofficial	polarmcp
Nourish (nutrition)	wellness-nourish	wellness-nourish

One-command setup for Hermes — preconfigures every connector above plus wellness skills + onboarding: delx-wellness-hermes.

<!-- /delx-wellness see-also -->

📧 Contact & Support

• 📨 support@delx.ai — general questions, integration help, partnerships
• 🐛 Bug reports / feature requests — GitHub Issues
• 🐦 Updates — @delx369 on X
• 🌐 Site — wellness.delx.ai

License

MIT — see LICENSE.

Disclaimer

This software is provided as-is. It is not a medical device, does not provide medical advice, and should not be used for diagnosis or treatment. The unofficial Garmin Connect mode can break if Garmin changes private auth or endpoints. Always consult qualified professionals for medical concerns.