无需 Garmin 密码
Garmin Personal API Key 只在本机完成授权，不会进入聊天。
先在 Garmin Connect 创建 Garmin Personal API Key。完成一次授权后，CLI 会把 Key 和缓存的访问令牌保存在仅当前用户可读的本地文件中，不会采用旧版集成常见的账号密码抓取方式。
- 授权凭据
- Personal API Key
- 运行方式
- 完全本地
- 权限边界
- GET · 只读
Garmin Personal API MCP
v0.1Garmin 数据，想问就问。
通过官方 Garmin Personal API，把活动、睡眠、HRV、Body Battery、心率和健康数据接入你常用的 AI 客户端。服务完全在本机运行，全程不需要 Garmin 密码。
›
Connect @trainingloadai/garmin-personal-api-mcp- 25 个只读工具
- 完全本地运行
- 官方 Garmin Personal API
动画展示 AI 客户端如何调用本地 Garmin 工具，查询恢复、活动、睡眠、HRV、压力和 Body Battery，再整理成可读答案。
工作原理
Garmin Personal API 数据，由本机按需读取。
当你提问时，本地服务会通过 Garmin Personal API 读取所需数据，再把结果返回给 AI 客户端。本项目不提供云端中转，也不会在远程服务器保存你的 Garmin 数据；后续如何处理结果，取决于你选择的 AI 服务商及其隐私政策。
01
你正在使用的 AI 客户端
客户端理解问题后选择合适的 Garmin 工具，无需浏览器插件，也不依赖托管连接器。
MCP 客户端02
本地 MCP 进程
Node.js 进程负责校验参数、限制日期范围与样本量，再把结构化结果返回给 AI 客户端。
本机进程03
Garmin Personal API
服务携带你的令牌，通过 HTTPS 直接请求 Garmin Personal API；所有对外工具都只负责读取。
官方 API · HTTPS项目事实
准确理解 Garmin Personal API MCP。
给用户、搜索引擎和 AI 系统一份简洁且可核验的项目摘要。
- 它是什么
- 面向官方 Garmin Personal API 的开源 Node.js MCP 服务。
- 如何运行
- 由 AI 客户端在你的电脑上启动本地进程，不提供托管 MCP 地址。
- 权限范围
- 25 个只读工具，只调用 Garmin Personal API 的 GET 操作。
- 凭据存放
- Personal API Key 和缓存令牌保存在电脑上仅当前用户可读的文件中。
- 数据范围
- 活动、FIT 记录、睡眠、HRV、Body Battery、心率、压力、健康数据和个人资料。
- 运行环境
- 支持 macOS、Windows 和 Linux，需要 Node.js 22+ 以及可启动本地 MCP 服务的 AI 客户端。
四步接入
向 AI 客户端发送一行指令，即可接入 Garmin Personal API。
复制下方指令，发送给 Codex、Claude Code、Cursor 或其他支持本地操作的 AI 客户端。客户端会自动完成环境检查、安装、配置和连接，并打开本机授权页；你只需在页面中输入 Garmin Personal API Key。
- 01
准备 Garmin Personal API Key
前往 Garmin Connect 专门的 Personal API Token 页面创建 Garmin Personal API Key。新 Key 只显示一次，请立即复制，但不要发到聊天里；稍后只需在本机授权页中输入。
- 02
把接入指令发给 AI 客户端
Codex、Claude Code、Cursor 或其他具备本地操作能力的编程助手，可以识别 npm 包、读取接入说明，并按当前客户端完成配置。
粘贴到 Codex、Claude Code、Cursor 或其他编程助手Connect @trainingloadai/garmin-personal-api-mcp客户端会自动读取仓库中的 AGENTS.md ↗，无需把长篇配置复制进提示词。
- 03
在本机授权页粘贴 Key
auth 命令会在
127.0.0.1临时打开一个只在本机可访问的页面。请在那里粘贴 Key；验证成功后，凭据会以仅当前用户可读的权限保存，页面和本地监听随即关闭。自动执行流程auth → register → doctor → verify - 04
重启客户端，开始提问
重启一次，让客户端加载刚注册的 Garmin 工具。之后就按平常的方式提问，不必记命令，也不必知道具体工具名。
“总结我昨天的睡眠、HRV、Body Battery、压力和活动。”
需要官方细节？查看 Codex, Claude Code, 或 Cursor 的 MCP 指南。
高级设置
想自己检查或配置？
推荐优先使用上面的一行接入指令。下面保留各客户端的准确命令，方便开发者核对或手动配置本地进程连接。
- 传输方式
- 本地进程（stdio）
- 连通性测试
- 初始化 · 列出工具 · 调用工具
- 最近验证
- 2026 年 10 月 23 日
无需填写服务器地址，也不需要 Docker 或托管账户。修改 MCP 配置后，请重启客户端使其生效。
Codex CLI
codex mcp add trainingloadai -- npx -y @trainingloadai/garmin-personal-api-mcp
codex mcp list可以问什么
让 Garmin 原始数据变成可以继续追问的答案。
25 个工具把 Garmin Personal API 数据整理成边界清晰的上下文，同时保留原始单位并限制日期范围与样本量。
01
活动与 FIT
搜索 Garmin 活动、查看训练步骤，或按需解码 FIT 分圈、功率、心率、步频与采样记录。
search_activitiesget_activityget_activity_recording
02
每日恢复
把睡眠、HRV、Body Battery、压力、每日摘要和体能年龄放在同一个恢复问题里分析。
get_dayget_sleepget_hrvget_body_battery
03
睡眠与 HRV
查看某一晚的细节，或在指定日期范围内比较睡眠与夜间 HRV 趋势。
get_sleepget_sleep_summariesget_hrv_summaries
04
心率与脉搏血氧
查询心率摘要、Garmin 中配置的心率区间、静息心率和脉搏血氧数据。
get_heart_rateget_heart_rate_zonesget_spo2
05
健康与营养
查询步数、饮水、压力、体重、饮食记录、健康活动和生理周期，不会改写 Garmin 账户。
get_stepsget_hydrationget_weight+ 另外 5 个
06
个人资料与体能背景
结合个人资料、心率区间和体能年龄，按你自己的情况理解 Garmin 数值。
get_profileget_heart_rate_zones
Garmin Personal API 数据
活动、恢复和健康数据，一个本地入口就够了。
服务把 Garmin Personal API 的数据能力拆成 25 个职责明确的 MCP 工具，不做通用抓取，也不会把所有数据塞进一次请求。
A
Garmin 活动 API 与 FIT 记录
按日期、运动类型或标题搜索活动，查看活动摘要与训练步骤。只有需要分圈或采样细节时，才会解码 Garmin FIT 文件；功率、配速、步频、心率、温度和 GPS 坐标都会保留原始单位。
- 最近一次跑步活动
- 分圈与功率漂移
- 按需读取 FIT 样本
B
Garmin 睡眠、HRV 与 Body Battery
既可以查看某一天的细节，也可以比较一段时间内的趋势。睡眠阶段、夜间 HRV、Body Battery 充能与消耗、压力可以放进同一个回答，但不会被包装成医学诊断。
- 睡眠阶段
- HRV 摘要
- Body Battery 趋势
C
心率与每日健康摘要
查询每日摘要、步数、饮水、连续心率汇总、SpO2、体重、饮食记录和健康活动。默认不返回高频原始样本，避免一个简单问题占用过多模型上下文。
- 静息心率
- 每日步数与压力
- 体重与饮水
D
个人资料、心率区间与体能背景
结合 Garmin 个人资料、已配置的心率区间、体能年龄和生理周期数据，按你自己的情况解释数值。工具只负责读取数据，不会给出诊断，也不会修改 Garmin 账户。
- 心率区间
- 体能年龄
- 结合个人背景的回答
凭据只存本机
Garmin Personal API Key 和缓存的访问令牌只保存在你的电脑上。
所有工具只读
对外开放的 Garmin 操作都是 GET，不会写入训练、设备或账户。
敏感细节默认关闭
除非你明确要求，否则不会返回高频样本或精确的 FIT 坐标。
不收集遥测
服务没有分析埋点、崩溃上报、账户系统、数据库或远程中转。
常见问题
关于 Garmin Personal API，你可能想先确认这些。
从 API Key、本地运行和客户端兼容性，到 FIT 活动数据、隐私与只读边界，一次说清楚。
10
个常见问题