← 返回目录

Garmin MCP Server

社区

访问 Garmin Connect 数据的 MCP 服务器，提供 110+ 工具覆盖健身、健康与训练分析。

GitHub 源仓库 ↗

★ 1.1k Stars 分类 · 其他非常热门源版本 3610be6feed9

72FMRS · B

可靠性

11/20

安全与权限

14/20

维护活跃度

16/20

文档质量

17/20

安装易用性

14/20

Garmin MCP 服务器提供丰富的工具覆盖 Garmin Connect 数据，适合希望将健身和健康数据集成到 AI 工作流程的用户。安装简便，支持多种客户端，但需要注意认证和 HTTP 安全。

查看 FMRS 评分方法 →

Garmin MCP 服务器连接 Garmin Connect，向 Claude 和其他兼容 MCP 的客户端暴露您的健身与健康数据。它基于 python-garminconnect 库，提供 110+ 个工具，覆盖活动管理、健康指标、训练负荷趋势、功率分析等，并支持高级功能如功率时长曲线、FIT 文件解析和电子变速智能分析。支持通过环境变量进行工具过滤，提供高层次的训练计划构建工具。

工具能力

暂未整理工具清单。

安装接入

使用 garmin-mcp-auth 进行一次认证，保存 OAuth 令牌到 ~/.garminconnect。
在 Claude Desktop 或支持 MCP 的客户端配置中添加服务器，使用 uvx 命令。
重启客户端，即可使用 Garmin 数据。

claude_desktop_config.json

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

Garmin 用户希望在 AI 助手中集中管理健身数据
需要自动化训练计划生成和调度的跑步者或骑行爱好者
希望使用自然语言查询健康趋势和训练负荷的分析型用户
开发者和爱好者希望集成 Garmin 数据到自定义工具链

不适合谁

非 Garmin 用户或无 Garmin 账户的人
需要实时 GPS 跟踪或即时数据推送的应用
希望绕过认证流程的用户（需要 Garmin 账户和 OAuth 令牌）
需要删除或修改核心活动数据的操作（部分编辑功能支持，但有风险）

所需权限

读取和编辑 Garmin Connect 数据（包括活动、健康指标、训练计划等）
下载活动文件到本地目录
创建和安排训练计划
访问用户的健康数据和身体组成数据

风险与副作用

需要存储 OAuth 令牌，令牌有效期为约 6 个月，过期需重新认证
HTTP 传输时不带认证，若暴露到公网需配置反向代理保护
部分破坏性操作（如删除活动）未实现以避免误操作
工具数量多可能增加 LLM 上下文负担，但可通过环境变量过滤

常见排障

确保 `uvx` 在 PATH 中，或使用绝对路径
检查 Garmin 凭据是否正确，以及是否启用 MFA
查看日志文件：macOS：`~/Library/Logs/Claude/mcp-server-garmin.log`，Windows：`%APPDATA%\Claude\logs\mcp-server-garmin.log`
若令牌过期，运行 `garmin-mcp-auth --force-reauth`
确认网络连接和 Garmin 服务正常

使用场景

查看最近的活动和详细活动信息

分析睡眠、压力、心率等健康指标

跟踪训练状态、CTL/ATL/TSB、HRV、VO2 max 趋势

创建和安排跑步、步行、力量训练等训练计划

下载活动文件（FIT、GPX、TCX、CSV）

分析骑行功率、FIT 文件、Di2 变速数据

支持客户端

Claude Desktop完整支持

Codex完整支持

opencode完整支持