M
MCP 精选目录 CURATED DIRECTORY
已收录 911 个 MCP Server
EN
← 返回目录
G

Garmin MCP Server

社区
访问 Garmin Connect 数据的 MCP 服务器，提供 110+ 工具覆盖健身、健康与训练分析。
查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗
分类
其他 第 6 / 230
Stars
★ 1.3k 非常热门
传输方式
stdio（本地进程） · Streamable HTTP · SSE
运行环境
Python 3.12+
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
72FMRS · B

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

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性
11/20
安全与权限
14/20
维护活跃度
16/20
文档质量
17/20
安装易用性
14/20
查看各项评分依据
可靠性 11/20
证据表明存在广泛的测试套件（200+集成测试，4个端到端测试）和CI工作流，这表明核心路径可能是可复现的。然而，由于审查是静态的，无法实际运行服务器，且缺少清单文件，因此无法验证工具声明与真实行为的一致性。分数上限为12，根据校准指南判为11。扣分原因：未能执行代码，存在未跟踪的依赖关系（如fitparse），以及可能影响可靠性的某些端点被故意省略。
安全与权限 14/20
该服务器处理敏感的Garmin凭据，支持基于文件的秘密和环境变量，并鼓励预认证以将令牌存储在~/.garminconnect中，限制暴露。它不记录凭据，并提供禁用破坏性工具（如删除活动）的选项。HTTP传输不提供任何认证，但文档明确指示将其置于反向代理之后。未发现恶意证据，未发现安全关键缺陷，因此可评为14。扣分原因：缺乏对令牌存储权限的明确说明，没有明确确认破坏性操作的处理方式，以及文档中提供示例密码配置。
维护活跃度 16/20
该仓库活跃，有大量提交和发布，维护者似乎积极响应问题（24个未决问题相对较低）。拥有MIT许可证。根据证据，不会扣分，但维护分值上限为20，因为未验证发布历史和依赖更新记录。得16分，以反映活跃度但缺乏持续治理的深度验证。
文档质量 17/20
README非常全面，包括安装、配置、故障排除、示例和限制披露。包含多种客户端的配置示例。文档似乎与功能一致，并明确说明了被跳过的端点。得17分，因为尽管文档详尽，但某些方面（如确切的工具参数和令牌权限）未完全详细说明。
安装易用性 14/20
安装步骤清晰，提供多种方式：uvx、Docker、Claude Desktop配置，以及对Codex和opencode的说明。提供了预认证工具garmin-mcp-auth，以简化认证过程。然而，由于是静态审查，无法验证安装的可靠性和兼容性，因此分数上限为15。得14分，因为文档似乎支持直接安装，但缺少实际验证。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python 3.12+

GARMIN_EMAIL 可选密钥 Garmin Connect 登录邮箱；可改用 GARMIN_EMAIL_FILE 指向存放邮箱的文件，两者不能同时设置。
GARMIN_EMAIL_FILE 可选密钥 包含 Garmin Connect 邮箱的文件路径，适合 Docker 等场景。
GARMIN_PASSWORD 可选密钥 Garmin Connect 登录密码；可改用 GARMIN_PASSWORD_FILE 指向存放密码的文件，两者不能同时设置。
GARMIN_PASSWORD_FILE 可选密钥 包含 Garmin Connect 密码的文件路径。
其他可选配置项（8 个）
GARMIN_IS_CN 可选 设为 true 时使用 Garmin Connect 中国版 (garmin.cn)，默认 false。
GARMIN_FIT_DOWNLOAD_DIR 可选 活动文件默认下载目录，设置后跳过 download_activity_file 的首次配置提示。
GARMIN_FIT_CONFIG 可选 持久化下载目录配置文件路径，默认 ~/.garminconnect_fit_config.。
GARMIN_ENABLED_TOOLS 可选 逗号分隔的工具白名单，仅注册列出的工具。
GARMIN_DISABLED_TOOLS 可选 逗号分隔的工具黑名单，注册时跳过这些工具；设置白名单后此项被忽略。
GARMIN_MCP_TRANSPORT 可选 传输方式：stdio（默认）、streamable-http 或 sse。
GARMIN_MCP_HOST 可选 HTTP 传输的绑定地址，默认 127.0.0.1。
GARMIN_MCP_PORT 可选 HTTP 传输的绑定端口，默认 8000。
  1. 使用 garmin-mcp-auth 进行一次认证，保存 OAuth 令牌到 ~/.garminconnect。
  2. 在 Claude Desktop 或支持 MCP 的客户端配置中添加服务器，使用 uvx 命令。
  3. 重启客户端，即可使用 Garmin 数据。
claude_desktop_config.json 
{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal
claude mcp add garmin -- uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

先运行 garmin-mcp-auth 完成登录，重启客户端后在工具列表中应能看到 garmin 服务器的工具，然后询问“我昨天走了多少步”，能返回数据即说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

  • 显示我最近的几次运动记录
  • 我昨晚的睡眠情况怎么样？
  • 展示我最近一次骑行的功率区间，并和我的训练区间做比较
  • 创建一个名为 W3 Mié 2:2 的跑步/步行间歇训练，跑2分钟走2分钟重复9次

使用场景

查看最近的活动和详细活动信息
分析睡眠、压力、心率等健康指标
跟踪训练状态、CTL/ATL/TSB、HRV、VO2 max 趋势
创建和安排跑步、步行、力量训练等训练计划
下载活动文件（FIT、GPX、TCX、CSV）
分析骑行功率、FIT 文件、Di2 变速数据

支持客户端

Claude Desktop
Codex
OpenCode

依据项目文档列出，未经本站实测。

详细介绍

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

同类可选方案

BioMCP 75 · B

统一的命令行语法，接入约30个可信生物医学数据源。

★ 653 · 工具数 11 与当前对比 →
与其他 MCP 横向对比

源版本 cfc5d799ab0f 数据同步于 2026-10-11 查看 FMRS 评分方法