v0.5.3

Fixed

• Native auth now detects Garmin SSO rate-limit and bot-protection failures instead of collapsing them into UNKNOWN.
• HTTP 429, Cloudflare-like non-JSON responses, and JSON responses without responseStatus.type now return actionable backoff guidance.
• CLI auth output no longer double-prefixes nested failures as "Garmin login failed: Garmin login failed: ...".
• garmin_quickstart now uses the current connection-status shape instead of stale has_credentials/token_present fields.

Changed

• README/docs now use a shorter agent-first front door and full docs/tools.md reference.
• Auth docs explain safe recovery for 429/Cloudflare without asking users to paste secrets.

Verification

• npm test
• npm audit --audit-level=low
• npm pack --dry-run
• GitHub CI and CodeQL passed

v0.5.2

What's changed

• Published npm package garmin-mcp-unofficial@0.5.2.
• Pins transitive Hono resolution to 4.12.27 to resolve production audit advisories while keeping the public MCP API unchanged.
• Synchronized release metadata across package and MCP server descriptors.

Verification

• npm audit --omit=dev --audit-level=moderate: 0 production vulnerabilities.
• npm test / prepublishOnly: passed.
• npm pack --dry-run: passed.

npm: https://www.npmjs.com/package/garmin-mcp-unofficial/v/0.5.2

v0.1.4 — Production-ready Garmin MCP

First public release of the unofficial Garmin Connect MCP server.

Features

• 34 read-only tools for profile, devices, daily summaries, sleep, heart rate, HRV, stress, Body Battery, training readiness, activities, weight and hydration.
• Daily and weekly agent summaries with data-quality confidence and non-medical action candidates.
• Privacy modes, token redaction, optional SQLite cache, local doctor checks.
• Hermes integration with pinned config and local skill.
• Local-first auth helper using garminconnect without storing Garmin passwords.

Install

npx -y garmin-mcp-unofficial setup
npx -y garmin-mcp-unofficial auth --install-helper
npx -y garmin-mcp-unofficial doctor

In your MCP client

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

Recent changes

• Fixed agent-facing docs links to use https://garminconnectmcp.vercel.app/
• Hermes setup configs include approvals.mcp_reload_confirm: false by default
• Expanded HTTP smoke coverage to exercise the real MCP /mcp protocol

Not affiliated with Garmin. Not medical advice. Garmin Connect personal mode is unofficial.

Full changelog · npm · Website