它能做什么

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

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

可以读取与执行

运动记录

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

睡眠与恢复

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

健康指标

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

训练与表现

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

训练计划

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

营养及更多

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

如何接入

第 1 步

复制服务器地址

https://shaojun.icu/garmin/mcp

第 2 步

添加到 MCP 客户端

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

第 3 步

选择区服并登录

登录页默认中国区；Global 用户可手动切换。输入 Garmin Connect 邮箱和密码，并在需要时完成 MFA。

第 4 步

开始提问

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

登录前请确认：Garmin 密码只使用一次且绝不保存；网关仅保存 AES-256-GCM 加密的会话令牌。健康数据按需转发，不持久化。请仅在信任运营者时使用：本实例由 the operator 运营。详见安全说明。

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

Tips & tricks

Prompts that show what the connector can really do — skills and ready-made prompt packs will land here too.

Prompt

Weekly review

“Summarize my training week: volume, intensity, sleep quality, and how my body handled the load. What should I change next week?”

Prompt

Coach mode

“Build me a 3-run week targeting a sub-50 10k — base it on my recent training load and schedule the workouts to my watch.”

Prompt

Sleep detective

“Look at the last month: which habits correlate with my worst sleep scores — late workouts, stress peaks, anything else?”

Under the hood

The Garmin smarts come from garmin_mcp, an open-source MCP server by Taxuspt — full credit to that project. It runs here unmodified; this site only operates it and adds the missing piece: a secure multi-user sign-in (OAuth 2.1), so you can connect from any Claude app without running a server or touching a config file yourself.

Everything is open source: the connector logic in garmin_mcp by Taxuspt, and this gateway is maintained by Charles. Audit either — or self-host the whole thing.

All tools

All 148 tools this connector currently exposes, grouped by area — straight from the garmin_mcp source (e8554bc). Click a group to expand.

Activities · 21 tools

get_activities_by_date: Get activities between specified dates with pagination support.
get_activities_fordate: Get activities for a specific date
get_activity: Get detailed information for a single activity.
set_activity_name: Set or update the name of an activity.
set_activity_type: Change the activity type (sport) of an activity.
set_activity_description: Set or update the free-text description (notes) of an activity.
set_activity_event_type: Set the event type of an activity.
set_perceived_effort: Set the perceived effort (RPE) for an activity.
set_activity_feel: Set how an activity felt ('How did you feel?').
get_activity_splits: Get splits for an activity
get_activity_typed_splits: Get typed splits for an activity
get_activity_split_summaries: Get split summaries for an activity
get_activity_weather: Get weather data for an activity.
get_activity_hr_in_timezones: Get heart rate data in different time zones for an activity
get_activity_power_in_timezones: Get power distribution across training zones for an activity.
get_activity_gear: Get gear data used for an activity
get_activity_exercise_sets: Get exercise sets for strength training activities
count_activities: Get total count of activities in the user's Garmin account
get_activities: Get activities with pagination support.
create_manual_activity: Log a manual activity in Garmin Connect — useful for activities done without a watch.
get_activity_types: Get all available activity types

Health & wellness · 30 tools

get_stats: Get daily activity stats with curated essential metrics
get_user_summary: Get user summary data (compatible with garminconnect-ha)
get_body_composition: Get body composition data for a single date or date range
get_stats_and_body: Get stats and body composition data
get_steps_data: Get detailed steps data with 15-minute intervals
get_daily_steps: Get steps data for a date range
get_training_readiness: Get training readiness data with curated metrics
get_body_battery: Get body battery data with events
get_body_battery_events: Get body battery events data
get_blood_pressure: Get blood pressure data
get_floors: Get floors climbed data
get_rhr_day: Get resting heart rate data
get_heart_rates: Get full heart rate time-series data
get_heart_rates_summary: Get heart rate summary with essential metrics (lightweight version)
get_hydration_data: Get hydration data
get_sleep_data: Get full sleep data with all details
get_sleep_summary: Get sleep summary with only essential metrics (lightweight version)
get_sleep_summary_range: Get lightweight sleep summaries for every night in a date range.
get_stress_data: Get full stress time-series data
get_stress_summary: Get stress summary with essential metrics (lightweight version)
get_respiration_data: Get full respiration time-series data
get_respiration_summary: Get respiration summary with essential metrics (lightweight version)
get_spo2_data: Get SpO2 (blood oxygen) data
get_all_day_stress: Get all-day stress data
get_all_day_events: Get daily wellness events data
get_lifestyle_logging_data: Get lifestyle logging data for a specific date
get_weekly_steps: Get weekly step data aggregates
get_weekly_stress: Get weekly stress data aggregates
get_weekly_intensity_minutes: Get weekly intensity minutes data aggregates
get_morning_training_readiness: Get morning training readiness score

Profile & settings · 6 tools

get_full_name: Get user's full name from profile
get_unit_system: Get user's preferred unit system from profile
get_user_profile: Get user profile information
get_userprofile_settings: Get user profile settings
get_heart_rate_zones: Get the user's saved heart-rate training-zone configuration.
set_heart_rate_zones: Set an account-level heart-rate training-zone configuration for one sport.

Devices · 6 tools

get_devices: Get all Garmin devices associated with the user account
get_device_last_used: Get information about the last used Garmin device
get_device_settings: Get settings for a specific Garmin device
get_primary_training_device: Get information about the primary training device
get_device_solar_data: Get solar data for a specific device
get_device_alarms: Get alarms from all Garmin devices

Gear · 3 tools

get_gear: Get all gear registered with the user account
add_gear_to_activity: Associate gear with an activity
remove_gear_from_activity: Remove gear association from an activity

Weight & body composition · 5 tools

get_weigh_ins: Get weight measurements between specified dates
get_daily_weigh_ins: Get weight measurements for a specific date
delete_weigh_ins: Delete weight measurements for a specific date
add_weigh_in: Add a new weight measurement
add_weigh_in_with_timestamps: Add a new weight measurement with specific timestamps

Challenges & badges · 9 tools

get_goals: Get Garmin Connect goals (active, future, or past)
get_personal_record: Get personal records for user
get_earned_badges: Get earned badges for user
get_adhoc_challenges: Get user-created social/group challenges (e.g., step competitions with friends)
get_available_badge_challenges: Get official Garmin badge challenges available to join
get_badge_challenges: Get all badge challenges the user has joined (completed and in-progress)
get_non_completed_badge_challenges: Get badge challenges currently in progress (not yet completed)
get_race_predictions: Get predicted race times based on current fitness level
get_inprogress_virtual_challenges: Get in-progress virtual challenges/expeditions

Training & performance · 18 tools

get_progress_summary_between_dates: Get progress summary for a metric between dates
get_hill_score: Get hill score data between dates
get_endurance_score: Get endurance score data between dates
get_training_effect: Get training effect data for a specific activity
get_hrv_data: Get Heart Rate Variability (HRV) data
get_fitnessage_data: Get fitness age data
get_training_status: Get training status with curated metrics
get_cycling_ftp: Get the latest cycling Functional Threshold Power (FTP) data.
get_lactate_threshold: Get lactate threshold data
request_reload: Request reload of epoch data
get_training_load_trend: Get the Performance Management Chart (CTL/ATL/TSB) over a date range.
get_training_load_balance: Get Garmin's Load Focus — the distribution of the trailing-month training load across Aerobic Low, Aerobic High, and Anaerobic intensity bands, plus the system's feedback phrase (e.g. AEROBIC_HIGH_SHORTAGE, BALANCED…
get_hrv_trend: Get HRV (Heart Rate Variability) trend over a date range.
get_vo2max_trend: Get VO2 max trend over a date range.
get_respiration_trend: Get overnight respiration rate trend over a date range.
get_running_tolerance: Get Running Tolerance for a single day.
get_running_tolerance_trend: Get Running Tolerance trend over a date range.
get_acclimation: Get heat and altitude acclimation status for a given date.

Workouts · 14 tools

get_workouts: Get all workouts with curated summary list
get_workout_by_id: Get detailed information for a specific workout
download_workout: Download a workout as a FIT file
upload_workout: Upload a workout from JSON data
upload_workouts: Upload multiple workouts from JSON data in a single call
delete_workout: Delete a workout from Garmin Connect
delete_workouts: Delete multiple workouts from Garmin Connect in a single call
get_scheduled_workouts: Get scheduled workouts between two dates with curated summary list
get_garmin_coach_workouts: Get Garmin Coach workouts around the given date
get_training_plan_workouts: Compatibility alias for get_garmin_coach_workouts
schedule_workout: Schedule a workout to a specific calendar date
schedule_workouts: Schedule multiple workouts to specific calendar dates
unschedule_workout: Remove a scheduled workout from the Garmin Connect calendar
unschedule_workouts: Remove multiple scheduled workouts from the Garmin Connect calendar

Data management · 3 tools

add_body_composition: Add body composition data
set_blood_pressure: Set blood pressure values
add_hydration_data: Add hydration data

Women's health · 3 tools

get_pregnancy_summary: Get pregnancy summary data
get_menstrual_data_for_date: Get menstrual data for a specific date
get_menstrual_calendar_data: Get menstrual calendar data between specified dates

Nutrition · 14 tools

get_nutrition_daily_food_log: Get daily food consumption records for a date
get_nutrition_daily_meals: Get daily meal summaries for a date
get_nutrition_daily_settings: Get nutrition plan/settings for a date
set_nutrition_daily_settings: Update daily nutrition goals (calorie target and macronutrient targets).
search_foods: Search Garmin's general food catalog (FatSecret + Garmin custom foods)
get_custom_foods: Search or list user's custom foods
get_custom_food_serving_units: Get available serving units for custom foods
create_custom_food: Create a custom food in the user's Garmin nutrition library
update_custom_food: Update an existing custom food in the user's Garmin nutrition library
delete_custom_food: Delete a custom food from the user's Garmin nutrition library
log_custom_food: Log a food item to a meal on a date
log_food: Quick-add a food entry with macro values to the nutrition log
delete_food_log: Delete a food log entry
upsert_and_log: Find-or-create a custom food then log it in one step

Workout builders · 5 tools

create_walk_run_workout: Create a walk/run interval workout and upload it to Garmin Connect.
create_run_workout: Create a continuous run workout and upload it to Garmin Connect.
create_z2_walk_workout: Create a steady Z2 walking workout and upload it to Garmin Connect.
create_strength_workout: Create a strength workout and upload it to Garmin Connect.
schedule_week: Schedule a list of workouts for the week in a single call.

Courses · 5 tools

get_courses: List all courses saved on Garmin Connect.
get_course_details: Get full details of a Garmin Connect course by ID.
download_course_gpx: Download the exact official GPX file for a Garmin Connect course.
upload_course: Upload a GPX file as a Garmin Connect Course.
delete_course: Delete a course from Garmin Connect.

Activity analysis · 5 tools

get_activity_fit_messages: Retrieve and generically parse an activity's original FIT file.
get_activity_fit_data: Download and parse FIT file for an activity to expose advanced cycling data.
get_power_duration_curve: Get season-best Power Duration Curve across recent activities.
download_activity_file: Download an activity and save it to disk as a file.
set_fit_download_dir: Set and persist the default directory for downloaded activity files.

Calendar events · 1 tools

get_calendar_events: Get races and events on the Garmin Connect calendar between two dates

Garmin 数据，交给你选择的 AI。

它能做什么

可以读取与执行

运动记录

睡眠与恢复

健康指标

训练与表现

训练计划

营养及更多

如何接入

复制服务器地址

添加到 MCP 客户端

选择区服并登录

开始提问

Tips & tricks

Weekly review

Coach mode

Sleep detective

Under the hood

All tools

Your watch has the answers.