Garmin Mcp Unofficial

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

<div align="center">

</div>

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

<p align="center">
<a href="https://www.npmjs.com/package/garmin-mcp-unofficial"></a>
<a href="https://www.npmjs.com/package/garmin-mcp-unofficial"></a>
<a href="LICENSE"></a>
<a href="https://wellness.delx.ai/connectors/garmin"></a>
</p>

<p align="center">
<a href="https://github.com/davidmosiah/garmin-mcp/stargazers"></a>
<a href="https://modelcontextprotocol.io"></a>
<a href="https://github.com/davidmosiah/delx-wellness-hermes"></a>
<a href="https://github.com/davidmosiah/delx-wellness"></a>
</p>

> ⚡ One-command install with Delx Wellness for Hermes:
> npx -y delx-wellness-hermes setup &mdash; preconfigures this connector and the full Delx Wellness stack in a dedicated Hermes profile.
>
> Or wire it standalone into Claude Desktop / Cursor / ChatGPT Desktop &mdash; 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">

</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)

…