Garmin Mcp Unofficial

Garmin MCP

让你的 AI Agent 获取 Garmin Body Battery、训练准备度、睡眠、HRV 和活动数据。
本地优先的 MCP 服务 — 令牌绝不会离开你的设备。

⚡ 使用 Delx Wellness for Hermes 一条命令即可安装： npx -y delx-wellness-hermes setup — 在专用的 Hermes 配置中预先配置此连接器和完整的 Delx Wellness 技术栈。

或将其单独接入 Claude Desktop / Cursor / ChatGPT Desktop — 请参阅下方的安装部分。可运行的示例见 Delx Wellness hub。

公开证明： Garmin MCP 收录于 Delx 开源增长快照，并与下载量、星标数和下一步行动优先级一同追踪。如果它帮你节省了配置 Garmin Connect 和 MCP 的时间，请为此仓库点个星标，让其他专注于训练的 Agent 构建者更快找到它。

第一个实用提示词： Use garmin_connection_status, then garmin_daily_summary, then give me a 5-line operating brief for today.

---

Garmin MCP

将 Garmin Body Battery、训练准备度、睡眠、HRV 和活动数据提供给你的 AI Agent——优先本地运行，令牌绝不离开你的设备。

非官方项目。 与 Garmin 无关联，也未获其认可或支持。这不是 Garmin Health API 官方合作接入，而是使用非官方的 Garmin Connect 个人令牌模式。

• 安装一个连接器 — npx -y garmin-mcp-unofficial setup
• 在以下应用中运行：Claude · Cursor · ChatGPT · Hermes · OpenClaw — 可运行示例
• 优先本地运行 — Garmin 令牌绝不离开你的设备（隐私）
• 该使用哪个连接器？ — 在 Delx Wellness 入口页中选择

这是 Delx Wellness 的一部分；Delx Wellness 是一个优先本地运行的健康 MCP 连接器目录。

60 秒快速入门

无需 Garmin 开发者应用。setup 只会写入本地 MCP 配置，不会要求你提供 Garmin 密码。

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

HTTP（v2 无状态）

默认使用 stdio。可选 Streamable HTTP——无会话 ID，返回 JSON，仅限环回地址：

npx -y garmin-mcp-unofficial --http
# GET  http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp   (sessionless)

环境变量：GARMIN_MCP_HOST、GARMIN_MCP_PORT、GARMIN_MCP_TRANSPORT=http。

也可一次性运行：npx -y garmin-mcp-unofficial setup --auth

auth 会运行独立的 Node 登录流程，并在本地提示你输入 Garmin 邮箱、密码，以及在需要时输入 MFA。MCP 不会存储你的 Garmin 密码——只保存 Garmin Connect 令牌，存放于 ~/.garmin-mcp/garmin_tokens.json，并设置仅用户可访问的权限。真实终端输出请参阅身份验证快速入门指南，完整流程请参阅 docs/quickstart.md。

如果 Garmin 返回 HTTP 429、Cloudflare 验证，或提示 Garmin SSO 未提供 responseStatus.type 的身份验证消息，请暂停一段时间，不要继续重试。反复尝试无头登录可能导致私有端点进一步限制请求。安全的恢复方法请参阅 docs/auth.md。

然后将以下内容添加到 MCP 客户端配置中：

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

在你的 Agent 中试用

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.

工具

先使用 garmin_connection_status，再使用 garmin_daily_summary（每日准备度、睡眠、负荷）或 garmin_weekly_summary（评分卡、瓶颈、下周计划）。此服务还提供每日信号（睡眠、HRV、压力、Body Battery、训练准备度、心率、SpO2、呼吸、强度分钟数、饮水量）、活动、个人资料/设备和体重，以及提示词和资源。

完整工具列表、提示词、资源、数据可用性矩阵、配置、Hermes 设置和开发说明请参阅 docs/tools.md。

隐私与离线运行内容

• GARMIN_PRIVACY_MODE 默认为 summary（比其他 Delx Wellness 连接器更保守），因为此身份验证模式并非官方方式。
• 在 structured 模式下，规范化别名是增补内容：完成上游 Garmin 字段和嵌套 DTO 会在清除机密信息/GPS 数据后继续提供。
• 活动日期范围会保留所提供的日历日期，并在联系 Garmin Connect 前拒绝无效值。
• Garmin Connect 令牌存储于 ~/.garmin-mcp/garmin_tokens.json，并设置仅用户可访问的权限；工具不会返回这些令牌。绝不存储你的 Garmin 密码——仅短期令牌会保存在本地。
• MCP 客户端无法看到 Garmin 凭据或令牌。本地缓存需通过 GARMIN_CACHE=sqlite 选择启用。
• 这不是医疗建议。此服务提供用户授权的数据，供个人 AI 工作流使用，不用于诊断或治疗。

完整隐私模型请参阅 docs/privacy.md。

查看完整的 Agent 演示 →

想看看这样的连接器如何驱动真实的端到端决策吗？共享且可复现的证明位于 delx-living-body：

npx -y delx-living-body demo

它通过整合 Delx Wellness 连接器中的恢复、睡眠和训练负荷信号，回答核心问题——“我今天应该进行高强度训练吗？”

另请参阅

完整的 Delx Wellness 连接器库：

提供方	软件包	仓库
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（营养）	wellness-nourish	wellness-nourish

Hermes 一键设置——预先配置上述所有连接器，以及健康工作流技能和入门引导：delx-wellness-hermes。

相关的本地优先健康 MCP

同类项目（非 Delx 软件包）：由 Kindred / @shkyyy18 开发的 mi-fitness-data-bridge——支持 Xiaomi Mi Fitness、本地优先，并采用 agent-safe-series/v1 密集序列封装格式（以时长为基准的覆盖范围、硬性 max_points、全分辨率统计数据，序列工具中不含 GPS）。设计记录：#19 · 一致性说明：docs/agent-safe-series-kindred.md。

📧 联系与支持

• 📨 [email protected] — 一般咨询、集成帮助、合作事宜
• 🐛 错误报告 / 功能请求 — GitHub Issues
• 🐦 最新动态 — X 上的 @delx369
• 🌐 网站 — wellness.delx.ai

许可证

MIT — 参见 LICENSE。行为准则。

免责声明

本软件按原样提供。它不是医疗器械，不提供医疗建议，也不应当用于诊断或治疗。如果 Garmin 更改私有身份验证机制或端点，非官方 Garmin Connect 模式可能会失效。涉及医疗问题时，请务必咨询合格的专业人士。

每日报告演示： docs/daily-brief-demo.md

Skill 或 MCP

同一个软件包，两种使用方式。MCP 会通过 stdio/HTTP 注册工具。Skill 则可在客户端不支持 MCP 时，通过 CLI 驱动同一批工具：

npx -y garmin-mcp-unofficial call garmin_connection_status --json '{}'

将 skill/SKILL.md 复制到你的 Agent 技能目录。