已上线

Garmin 运动数据,
交给你选择的 AI

训练、睡眠、恢复与健康数据,通过一个 MCP 地址进入对话。中国区为默认入口,同时支持 Global。兼容支持 Streamable HTTP 与 OAuth 的 MCP 客户端。

查看接入步骤 国际版接入步骤 服务器地址:https://shaojun.icu/garmin/mcp

它能做什么

Garmin Connect 记录了大量运动与健康数据,但在 App 里往往需要逐页查看。接入后,你可以直接问:“我这周睡得怎么样?”、“比较最近三次长跑”、“为什么今天的训练准备度较低?”

兼容 MCP 的 AI 客户端可以按需读取这些数字,关联睡眠与表现、总结训练周期,也可在确认后创建并安排训练计划。

可以读取与执行

运动记录

跑步、骑行、游泳与力量训练,以及分段、心率区间、功率、天气和装备。

睡眠与恢复

睡眠阶段与评分、HRV、身体电量、压力和晨间训练准备度。

健康指标

步数、心率、呼吸、血氧、血压、补水与体重趋势。

训练与表现

训练状态与负荷、最大摄氧量趋势、比赛预测、耐力与爬坡评分。

训练计划

不仅能读取数据;还可创建间歇、力量与 Zone 2 训练,并安排到 Garmin 日历。

营养及更多

饮食记录、称重、身体成分、装备追踪、设备、徽章与挑战。

如何接入

统一 MCP 服务地址

中国版与国际版共用高可用统一网关,两区账号独立隔离,由登录授权自动路由。

https://shaojun.icu/garmin/mcp

第 1 步

获取统一服务地址

复制上方的统一 MCP 服务器地址。中国版与国际版共用同一加密入口。

第 2 步

添加到 MCP 客户端

在客户端中新增远程 MCP 服务器并粘贴地址。OAuth Client ID 与 Client Secret 留空,由服务器自动注册。支持 Claude、ChatGPT、Codex、Gemini CLI、Qwen Code 和 DeepSeek Harness 等兼容客户端。

第 3 步

勾选【中国区】并登录

登录授权页单选确认勾选【🇨🇳 中国区(garmin.cn)】。输入在 Garmin Connect 中国区注册的账号与密码。

第 4 步

开始提问

客户端会自动发现 Garmin 工具。可以先问:“我昨晚睡得怎么样?”

💡 中国版贴士:适合国行购买的 Garmin 手表或在 Garmin Connect App 选择“中国大陆”区域注册的账号。
第 1 步

获取统一服务地址

复制上方统一地址。全球直连同一安全网关,自动智能调度 Global 端点。

第 2 步

添加到 MCP 客户端

在 AI 客户端中创建 Remote Server 并填入地址,无需配置任何 OAuth 凭证,系统支持 DCR 动态发现。

第 3 步

勾选【国际版 Global】登录

在授权页面切换为【🌐 国际版 Global(garmin.com)】,输入你的全球账户邮箱与密码,完成直连授权。

第 4 步

全球 SSO 守护 & 开启提问

内置 SsoBreaker 智能熔断与探活,保障连接高可用。授权成功即可全面分析国际版健康表现!

🌐 国际版贴士:适合海外购买的手表(美版/欧版/亚太版等)或在海外官网注册的账号。与中国区完全独立,同邮箱可并存。
安全保障:Garmin 密码仅在初次登录授权时用于验证,绝不持久化保存;服务仅保存经过 AES-256-GCM 加密的会话令牌。健康运动数据全程按需加密转发,不在网关沉淀。详见安全说明。

ChatGPT 的菜单路径略有不同,可查看专门接入指南;其他客户端使用同一个 MCP 地址。

中国版与国际版支持与常见问题

如何确认我的手表和账号是属于国行中国版还是国际版?

查看你使用的 Garmin Connect App 或网页版登录地址:若登录域名为 connect.garmin.cn 或在 App 中注册服务区域选择“中国大陆”,即为中国版;若登录域名为 connect.garmin.com 或在海外注册绑定,即为国际版。购买海外版手表(如美版、欧版、日版)配对国际版账号,购买国行手表配对中国版账号,两版均已获得本网关原生深度支持。

同一个邮箱在中国版和国际版分别注册了,数据会冲突或混淆吗?

绝不冲突。网关底层采用严格的命名空间级隔离存储(中国区账号键为 cn:email,国际版账号键为 global:email)。各版本独立的会话令牌使用 AES-256-GCM 单独加密存储,两区的数据查询与写入完全独立并行,互不干扰。

海外购买的手表和国际版账号,连接体验与功能有区别吗?

功能完全一致且同等完备。无论是中国版还是国际版,均可无缝读取 153 项 Garmin 核心数据与指令接口(包含心率、睡眠阶段、HRV、身体电量、训练准备度、历史活动及日历训练安排)。

国际版访问海外 Garmin 服务器,网络连接稳定吗?会遭遇频控吗?

网关集成了上游最新的 Garmin SSO 熔断器(SsoBreaker)与实时探活(SsoProbe)机制。当国际版 SSO 遇到海外 Cloudflare 临时 429 频控时,网关会智能启动 300 秒冷却保护与快速失败提示,避免长时间无意义超时阻塞,全链路保障高可用与账户安全。

使用技巧

展示连接器真正能力的提示词。

提示词

每周回顾

“总结我的训练周:运动量、强度、睡眠质量,以及身体对负荷的响应。下周应该调整什么?”

提示词

教练模式

“为我制定一个目标 50 分钟内 10 公里的三跑周 — 基于我最近的训练负荷,并将训练安排到手表。”

提示词

睡眠侦探

“看看最近一个月:哪些习惯与我最差的睡眠评分相关 — 晚间训练、压力峰值、还是其他?”

技术细节

知动 为 Garmin 运动数据接入提供了安全的多用户授权网关(OAuth 2.1 + PKCE),让你可以从任何支持 MCP 的 AI 客户端直接连接,无需在本地配置复杂环境或单独运行服务。

网关采用会话隔离与严格的数据传输边界,仅在对话需要时按需读取运动健康数据,全流程保障数据隐私与安全。

所有工具

知动现已深度接入全部 153 项 Garmin 核心数据与指令接口,按运动科学与健康管理场景分类。支持任何兼容 MCP 的 AI 模型精准调用。点击类别展开查看:

心率与核心健康体征监测 · 9 个接口
get_heart_rates
获取全天高精度心率时序数据,精准还原静息与活动中心率起伏趋势
get_heart_rates_summary
获取每日心率精简摘要(包括最高心率、最低心率与静息心率)
get_rhr_day
获取全天平均静息心率(RHR),评估心血管基础负荷与身体状态
get_spo2_data
获取单日及夜间脉搏血氧饱和度(SpO2)时序与平均水平
get_respiration_data
获取呼吸频率连续时序(包含清醒与睡眠期间每分钟呼吸频次)
get_respiration_summary
获取全天呼吸频率关键指标简报与波动范围
get_respiration_trend
查询指定日期跨度内的夜间呼吸频率变化走势
get_blood_pressure
查询历史血压测量记录(收缩压、舒张压与测量时心率)
set_blood_pressure
手动录入或同步单次血压测量数据
睡眠恢复、压力与身体电量 · 13 个接口
get_training_readiness
获取当日综合训练准备度评分及关键维度分析(睡眠、恢复、HRV与负荷)
get_morning_training_readiness
获取早晨醒来时的初始训练准备度评分,指导全天运动强度
get_recovery_time_remaining
获取指定日期的剩余恢复时间(小时),优先依据训练准备度快照或近期活动负荷衰减推算
get_body_battery
获取身体电量(Body Battery)充放电连续数据与当前能量储备
get_body_battery_events
查询身体电量充放电关键事件(睡眠/休息充能、高强度活动消耗)
get_sleep_data
获取完整睡眠报告(深睡、浅睡、REM快速眼动阶段分布与夜间醒来频次)
get_sleep_summary
获取单夜睡眠精简摘要(包含睡眠总时长与整体睡眠质量评分)
get_sleep_summary_range
批量拉取指定日期范围内每晚的轻量级睡眠质量与时长汇总
get_stress_data
获取全天连续生理压力指数时序(0-100分级动态)
get_stress_summary
获取单日生理压力核心摘要及休息、低度、中度、高度压力时长占比
get_all_day_stress
获取全天综合平均压力评分及压力等级总体分布
get_all_day_events
查询全天健康与生理压力关键事件日志
get_weekly_stress
查询按周聚合的历史生理压力均值走势
跑步与多运动训练记录 · 23 个接口
get_activities
支持分页检索账户下所有历史运动训练记录列表
get_activities_by_date
按指定的起始与截止日期范围检索运动记录(支持分页)
get_activities_fordate
检索特定日期的全部运动训练活动详情
get_activity
根据活动 ID 查询单次运动的完整详细数据(距离、配速、爬升、热量等)
get_activity_splits
获取单次跑步或骑行运动的每公里/英里分段配速与指标
get_activity_typed_splits
获取按间歇、休息、热身等训练类型细分的高级分段数据
get_activity_split_summaries
获取单次运动各分段的综合汇总统计指标
get_activity_weather
获取运动开始与结束时的气温、湿度、风速与天气状况
get_activity_hr_in_timezones
获取单次运动在各个心率区间(Zone 1~5)内的停留时间分布
get_activity_power_in_timezones
获取跑步或骑行运动在不同功率区间的用时分布
get_activity_gear
获取某次运动所绑定的跑鞋、自行车或外接配件装备
get_activity_exercise_sets
获取力量训练活动中的具体动作组数、负重重量与重复次数
count_activities
统计当前 Garmin 账户累计记录的运动活动总场次
get_activity_types
查询 Garmin 支持的全部运动类型列表(跑步、越野跑、骑行、游泳等)
create_manual_activity
手动补录未佩戴手表记录的运动活动(如室内跑步机、球类运动)
set_activity_name
修改或更新指定运动记录的展示名称
set_activity_type
修改指定运动的运动类型(例如将普通跑步更正为越野跑或田径跑)
set_activity_description
为指定运动添加或更新自由文本备注、训练笔记与心得
set_activity_event_type
设置运动活动分类性质(如日常训练、正式比赛、交通通勤或健身)
set_perceived_effort
记录运动员自我体感的主观自觉用力程度(RPE 评分,1-10分)
set_activity_feel
记录运动结束时的自我感受反馈(极佳、良好、一般、疲惫等)
delete_activity
从 Garmin Connect 永久删除指定活动(默认预览确认,防止误删)
set_activity_exercise_sets
更新或修正力量训练等活动的动作组数据(动作分类、动作名称、重量、次数,支持保留原记录起止时间)
高阶运动动力学与功率分析 · 5 个接口
get_activity_fit_data
解析运动生成的原始 FIT 文件,提取高阶骑行与跑步动力学数据
get_activity_fit_messages
检索并解析原始 FIT 二进制数据中的底层传感器原始消息流
get_power_duration_curve
获取近期最佳功率持续时间曲线(Power Duration Curve)
get_cycling_ftp
获取最新骑行功能阈值功率(FTP,单位:瓦特)及测定记录
get_lactate_threshold
获取乳酸阈值心率与阈值配速测定数据,精准指导乳酸门槛跑
训练负荷、体能状态与比赛预测 · 16 个接口
get_training_status
获取当前整体训练状态评估(高效提升、维持体能、超量恢复、疲劳过载等)
get_training_effect
获取单次运动的训练效果评估指标(有氧 TE 与无氧 TE 评分)
get_training_load_trend
获取长期训练负荷变化走势(包含长期适能 CTL、短期疲劳 ATL 与体能平衡 TSB 图表)
get_training_load_balance
获取四周负荷焦点平衡(低强度有氧、高强度有氧、无氧爆发力的配比状态)
get_vo2max_trend
追踪最大摄氧量(VO2 Max)历史变化曲线,衡量心肺有氧耐力发展
get_hrv_data
获取单日夜间心率变异性(HRV)基准值、平均值与偏离状态
get_hrv_trend
获取中长期夜间 HRV 均值走势,评估自主神经系统平衡与恢复潜能
get_race_predictions
获取基于当前生理体能预测的 5公里、10公里、半程马拉松与全程马拉松成绩
get_endurance_score
获取 Garmin 耐力评分(Endurance Score)长期走势与能力等级
get_hill_score
获取 Garmin 爬坡评分(Hill Score)及爬坡耐力、爬坡力量细项得分
get_running_tolerance
获取跑者当日跑步负荷承载力(Running Tolerance)评分
get_running_tolerance_trend
追踪指定周期内跑者跑步耐受力变化趋势,预防过度训练损伤
get_fitnessage_data
获取基于心肺耐力计算的身体适应性年龄(Fitness Age)与同龄人对比
get_acclimation
获取机体对高温气候(热适应)与高海拔环境(高反适应)的适应进度百分比
get_progress_summary_between_dates
统计指定时间跨度内某项运动指标的累积达成进度
request_reload
请求服务器主动重新刷新并同步阶段性健康与训练聚合数据
结构化课表构建与日历安排 · 22 个接口
get_workouts
查询个人账户中保存的全部结构化训练课表清单
get_workout_by_id
查询特定单份训练课表的具体阶段步骤、目标配速或心率区间
create_run_workout
自动创建按目标配速与距离执行的连续跑步训练课表并同步至手表
create_run_interval_workout
创建基于重复组的高阶跑步间歇课表(包含热身、精准心率/配速间歇组、恢复慢跑与冷身)并同步至手表
create_walk_run_workout
创建走跑交替/间歇训练课表并一键下发到 Garmin 设备
create_z2_walk_workout
创建二区(Zone 2)稳态燃脂走跑有氧课表
create_strength_workout
创建结构化力量训练课表(包含动作名称、组数、重量与组间间歇)
upload_workout
通过 JSON 结构化数据向 Garmin Connect 上传导入自定义课表
upload_workouts
批量上传导入多份结构化训练课表到个人课表库
schedule_workout
将指定训练课表排定至 Garmin 日历中的特定日期
schedule_workouts
批量将多份训练任务安排至未来指定日程
schedule_week
一键按周将未来 7 天的训练课表打包排入 Garmin 日历
unschedule_workout
从 Garmin 日历中撤销已排定的单次训练课表
unschedule_workouts
批量清除日历中已排定的多项训练任务安排
delete_workout
从个人课表库中彻底删除指定训练模板
delete_workouts
批量删除不需要的历史训练模板
download_workout
将训练课表导出为标准的 FIT 二进制文件
get_scheduled_workouts
检索指定起止日期内已排入日历的待执行课表任务
get_garmin_coach_workouts
查询 Garmin 智能教练(Garmin Coach)计划在指定日期的自适应训练
get_training_plan_workouts
查询正在参与的官方训练计划在指定日期前后的执行任务
get_calendar_events
获取 Garmin Connect 个人日历中标记的重要比赛与赛事日程
reschedule_workout
将日历中已安排的训练课表原位改期移动至新日期(无需重新创建日历条目)
越野路线、赛道与高程导航 · 3 个接口
get_courses
列出 Garmin Connect 中保存的全部跑步与骑行路线轨迹
get_course_details
获取单条路线的完整地理节点、爬升起伏、总距离与海拔剖面图
delete_course
从个人路线库中删除不需要的路线轨迹
体重趋势与身体成分管理 · 8 个接口
get_weigh_ins
查询指定起止日期区间内的历史体重测量数据
get_daily_weigh_ins
获取指定日期的单日称重记录详情
add_weigh_in
快速录入一笔新的体重测量数据
add_weigh_in_with_timestamps
支持精确时间戳录入单次体重测量记录
delete_weigh_ins
删除指定日期的历史称重记录
get_body_composition
获取详细身体成分数据(体脂率、骨骼肌量、体内水分比例、骨量及 BMI)
add_body_composition
提交录入身体成分全套多维指标数据
get_stats_and_body
联合查询单日的日常活动统计与身体成分指标
日常步数、爬楼与健康打卡 · 11 个接口
get_stats
获取单日核心健康仪表盘汇总数据(步数、活动卡路里、心率、距离等)
get_stats_range
按起止日期范围批量获取每日轻量级卡路里消耗与步数汇总
get_user_summary
获取当日用户日常活动综合摘要统计
get_steps_data
获取全天高精度步数数据(包含 15 分钟级步数与步频连续时序)
get_daily_steps
按日期范围查询每日累计步数列表
get_weekly_steps
查询按周聚合的历史日均步数变化走势
get_floors
获取当日爬楼层数统计及目标达成进度
get_weekly_intensity_minutes
查询按周聚合的中高强度活动分钟数(适度有氧与剧烈运动用时)
get_hydration_data
获取单日饮水量统计与补水目标打卡记录
add_hydration_data
记录并增加单次水分补充(单位:毫升)
get_lifestyle_logging_data
查询特定日期的生活方式与健康习惯打卡日志
跑鞋里程与运动装备寿命管理 · 3 个接口
get_gear
查询账号下绑定的所有跑鞋、自行车与硬件配件(包含累计里程与寿命上限)
add_gear_to_activity
将特定跑鞋或运动器材关联至单次运动记录中
remove_gear_from_activity
从某次运动记录中解除指定装备的关联绑定
智能穿戴硬件与设备监控 · 7 个接口
get_devices
查询当前 Garmin 账户下绑定的全部手表、码表及智能外设
get_device_last_used
获取用户最近一次同步或佩戴的主力穿戴设备信息
get_device_settings
获取指定 Garmin 穿戴设备的个性化功能开关与设置参数
get_primary_training_device
获取指定为主训练设备(Primary Training Device)的穿戴设备信息
get_device_solar_data
获取支持太阳能充电手表的受光强度曲线与太阳能能量收集效率
get_device_alarms
读取 Garmin 手表及关联设备中设定的全部闹钟配置
push_workout_to_device
将自建或库中的训练课表推送发送至指定的 Garmin 手表/设备
女性健康与生理周期追踪 · 3 个接口
get_menstrual_data_for_date
查询指定日期的生理周期阶段、身体症状反应与情绪打卡记录
get_menstrual_calendar_data
获取指定时间段的月经周期日历分布及排卵预测期
get_pregnancy_summary
获取孕期健康追踪摘要、胎动计数与孕周成长进展
膳食热量与营养摄入追踪 · 16 个接口
get_nutrition_daily_food_log
查询指定日期的进食详细清单与各餐次卡路里数据
get_nutrition_summary_between_dates
按起止日期范围批量获取每日营养摄入量、卡路里与宏量营养素汇总
get_nutrition_daily_meals
获取按早餐、午餐、晚餐、加餐分类的营养摄入汇总
get_energy_balance
结合饮食摄入、日常总消耗与体脂体质变化趋势,精准测算每日能量平衡与真实 TDEE
get_nutrition_daily_settings
获取当前设定的每日热量摄入目标与宏量营养素目标配比
set_nutrition_daily_settings
更新每日目标卡路里摄入上限及碳水、蛋白质、脂肪分配目标
search_foods
在认证食品营养数据库中搜索食材与现成食物的营养成分
get_custom_foods
获取用户个人自定义建立的专属食物与常用食谱列表
get_custom_food_serving_units
查询自定义食物支持的份量规格与计量单位
create_custom_food
在个人专属食物库中新建自定义食物条目与宏量营养值
update_custom_food
修改或更新已存在的自定义食物条目营养成分
delete_custom_food
从个人食物库中彻底删除指定食物条目
log_food
快速向饮食日记中记入一笔食物热量与营养数据
log_custom_food
将自定义食物添加至某日指定餐次(如早餐、运动后补给)
delete_food_log
从饮食日记中删除已记录的一餐食物
upsert_and_log
智能一步完成:若食物不存在则创建条目并即时记入单日饮食日记
挑战徽章与个人最好成绩 (PR) · 8 个接口
get_personal_record
查询跑步(最快 1k/5k/10k/半马/全马)、骑行或力量的历史个人最好成绩(PR/PB)
get_goals
查询在 Garmin Connect 中设立的个人活动目标及达成百分比
get_earned_badges
获取当前账号已解锁获得的全部 Garmin 官方成就勋章
get_available_badge_challenges
检索当前赛季正在开放加入的 Garmin 官方勋章挑战活动
get_badge_challenges
获取用户已参加的全部官方勋章挑战(含已达成与进行中)
get_non_completed_badge_challenges
检索正在进行中、尚未达成目标的勋章挑战
get_inprogress_virtual_challenges
查看正在参与的虚拟探险(如攀登珠峰、探索大峡谷)挑战进度
get_adhoc_challenges
查询与好友建立的自定义运动步数社交挑战
用户档案与运动心率区间设置 · 6 个接口
get_heart_rate_zones
获取用户为特定运动(如跑步、骑行、游泳)配置的专用心率区间分布
set_heart_rate_zones
更新指定运动类型的五区间心率阈值上下限(Zone 1~5)
get_full_name
获取 Garmin 账户中登记的用户姓名或昵称
get_user_profile
获取用户的个人运动档案基本信息(身高、体重、出生年等)
get_userprofile_settings
查询账户的隐私偏好设置与数据同步开关
get_unit_system
查询用户偏好的计量单位制式(公制 km/kg 或英制 mi/lb)
🚀 前沿拓展能力与规划领域 · 4 项前沿规划
规划中 🚀 跨品牌数据流统一聚合 (Cross-Brand Multi-Sensor Hub)
打破单一生态壁垒,将 Garmin、COROS 高驰、Apple Health、WHOOP 等异构穿戴数据清洗并归一化为统一的生理状态张量,供大模型一站式全面分析。
规划中 🏃 AI 赛事动态配速与能量补给策略 (AI Marathon Pacing & Fueling Engine)
基于选手近 12 周真实训练负荷、心率漂移阈值、临界配速(CP)与赛道高程剖面图,动态生成马拉松全程分段配速策略与碳水/电解质补给窗口。
规划中 🧬 生物学机体年龄与长寿健康评估 (Biomarker & Biological Aging Index)
综合静息心率离散度、慢波深睡时长比重、夜间 HRV 恢复斜率与有氧耐力指数,评估机体生理退行与年轻化恢复态势。
规划中 ⚠️ 心血管异常负荷与过度训练预警 (Cardiovascular Strain & Fatigue Guard)
识别训练过载(Overtraining)与疲劳未消退特征,监测睡眠异常心率高点与 HRV 连续走低信号,主动提醒调整训练或启动强制休整。

让手表里的运动数据,
成为你的智能外脑。

两分钟快速接入 — 会话隔离安全运行,全链路加密,随时可撤销授权。

立即接入 Garmin