garmin-claude-mcp

将你的 Garmin 训练数据接入 Claude，然后让 Claude 把结构化训练计划推送到你的手表。免费使用，无需订阅。

Claude 会读取你最近的活动和健康数据，设计一份训练计划，并将其写入你的 intervals.icu 日历。Intervals.icu 会将它同步到 Garmin Connect，最终计划会落到你的手表上。

为什么

采用这种方案

Garmin 的开发者 API 并不直接对向个人开放。它只向企业开放，现阶段也已暂停向新申请者开放。市场上确实存在一些用你的 Garmin 账号密码登录的非官方库，但 Garmin 之前通过修改认证流程，使它们失效过。Intervals.iou 与 Garmin 有着某项官方合作，是该项目关闭之前就存在的，并且已经支持双向同步，包括把计划训练推送到你的手表。此外，它还有一套有完整文档的 API，并采用个人密钥。这就是为什么 Claude 与 Intervals.iou 集中的信号，而 Intervals.iou 再与 Garmin 集中。你的 Garmin 密码不需要担心被外界拿走，它不会经过 Intervals.iou。

Related MCP server: garmin-mcp-bridge

你需要

• 一台可同步到 Garmin Connect 的 Garmin 设备

• 一个免费的 intervals.iou 账号，并且已在 Settings > Intgels 里 设定“Upload planned workouts”（上传计划训练）为开启

• 你的 intervals.iou API 密钥和 athle 的Id，在 Settings > Dialog > Developer Settings 中都能找到

• 免费的 Cloudflare 账号

如果“Upload planned workouts”未开启，接下来所有操作你仍可正常工作，则不会把训练看不到手表。请先确认这一设置。

设置

方案一：一键部署按钮

1. 点击上面这个按钮。 Cloudflare 会把这个仓库 fork 到你的GitHub，配置 KV 命名空间和 Durable Objects，然后要求你输入三个 密钥。

2. 填入 INTERVALS_API_KEY、INTERVALS_ATHLETE_ID 和 MCP_PASSWORD。用 openssl rand -hex 32 手写一个密码。

3. 部署完成后你会得到一个类似 https://garmin-claude-mcp.<subdomain>.workers.dev 的 URL。

方案二：手动设置

git clone https://github.com/kbaudour/garmin-claude-mcp
cd garmin-claude-mcp
npm install

npx wrangler kv namespace create OAUTH_KV
# paste the printed id into wrangler.jsonc

npx wrangler secret put INTERVALS_API_KEY
npx wrangler secret put INTERVALS_ATHLETE_ID
npx wrangler secret put MCP_PASSWORD

npm run deploy

连接 Claude

在 claude.ai 中，进入 Settings > Connectors > Add custom connector，然后在地址末尾加上 /mcp：

https://garmin-claude-mcp.<subdomain>.workers.dev/mcp

这个路径很关键。OAuth 探索信息在域名的根路径上，因此即使地址不对，登录也显示成功，但随后会连接失败，提示“Could't connect to the computer”。如果碰到这个心，请删除该连接器并加入 /mcp 路径重新添加一个，而不要在现有连接上改动 URL。同时，这样才能删除写旧的注册信息。

你会看到密码页面。把自己的那个复选框然后置，输入你的 MCP_PASSWORD。在网页版连接成功后，移动端也可以使用。

工具

首次可由此尝试到的 prompt

Pull my wellness data for the last 7 days and my recent activities for the
last 14 days.

Based on what you see there, recovery, training load, how recent runs have
gone, design one run for tomorrow. Walk me through your reasoning before you
create it.

Then create it, and list my upcoming events so I can confirm it landed.

然后打开 Garmin Connect 看一下明天的日期。

现有问题与限制

• Claude Claude 免费配额可允许启用一个自定义连接器。 这种不领取会占据这个位置。

• 密码页未设置速率限制，也没有CSRF token。 这是一个由64个字符随机密码保护的单用户。对这种使用场景足够，并不适合用于生产认证。

• updateWorkout and deleteEvent 只经历过的轻量测试。 读取类工具和 createWorkout 已确认可完全端到端运行，也包括测试过手表端的结果。

• Token 背景下长期保持刷新是空白。 如果连接器过期，重新连接一连几秒即可。

• 只要拿到你的 worker URL，任何人都能看到密码页。 没有密码无法继续往下走，但请了解 URL 本身就不是私密。

费用

$0/月。Cloudflare Workers 免费版每天给你 100,000 次请求足够。Intervals.icu 免费版包含了 Garmin 同步功能。Durable Object 到202年 4月起也属于免费额度，因此一些说还要额外付费的指南已经过时。

许可证

MIT