Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Garmin's API is accessed via the awesome python-garminconnect library.

Features

• List recent activities with pagination support
• Get detailed activity information
• Edit activities: name, type, description/notes, event type, perceived effort (RPE), feel, and strength exercise sets
• Access health metrics (steps, heart rate, sleep, stress, respiration)
• View body composition data
• Track training status and readiness
• Access cycling FTP and lactate threshold metrics
• Manage gear and equipment, including free-text notes returned by get_gear
• Access workouts and training plans
• Inspect detailed workout step structures, including repeat groups and swim pace targets
• Weekly health aggregates (steps, stress, intensity minutes)
• Advanced cycling analytics: power zones, FIT file analysis, DI2 electronic shift intelligence
• Training load trend (CTL/ATL/TSB), HRV trend, VO2 max trend, respiration rate trend
• Power Duration Curve, climb detection with VAM, cardiac drift (aerobic decoupling), W/kg calculations

Tool Coverage

This MCP server implements 110+ tools covering ~90% of the python-garminconnect library (v0.3.2):

• ✅ Activity Management (21 tools) - includes write tools for type, description, event type, perceived effort, feel, and exercise sets
• ✅ Health & Wellness (34 tools) - includes custom lightweight summary tools
• ✅ Training & Performance (13 tools) - includes CTL/ATL/TSB, HRV, VO2 max, and respiration trends
• ✅ Workouts (8 tools)
• ✅ Devices (8 tools) - includes sending a workout to a device
• ✅ Gear Management (5 tools)
• ✅ Weight Tracking (5 tools)
• ✅ Challenges & Badges (10 tools)
• ✅ Nutrition (9 tools) - food logs, meals, custom foods, food logging, and multi-day intake summaries
• ✅ Women's Health (3 tools)
• ✅ User Profile (3 tools)
• ✅ High-Level Workout Builders (4 tools) - create and schedule workouts without writing JSON
• ✅ Courses (5 tools) - list / get details / upload GPX as course / download GPX / delete course
• ✅ Activity Analysis (2 tools) - FIT file parsing, Power Duration Curve; requires power meter and/or Di2
• ✅ Activity File Downloads (2 tools) - download activity files in FIT, GPX, TCX, or CSV format

Note: Activity Analysis tools require a compatible power meter (e.g., Garmin Rally, Favero Assioma, PowerTap P1) and/or Shimano Di2 / SRAM eTap electronic shifting. The fitparse dependency is installed automatically.

Gear Notes

Each item in the gear array returned by get_gear includes a notes field containing the free-text Notes value shown in Garmin Connect. Gear without a Notes value returns null; all existing gear fields remain unchanged.

Activity File Downloads

Two tools let you download a raw activity file to disk:

• download_activity_file(activity_id, format="fit", output_dir=None) — downloads the activity and saves it to the configured directory. format accepts fit (default), gpx, tcx, or csv.
• set_fit_download_dir(path) — sets and persists the default download directory (written to the config file).

Where files are saved (precedence):

1. output_dir argument — one-off override, not persisted.
2. GARMIN_FIT_DOWNLOAD_DIR environment variable.
3. Persisted config set via set_fit_download_dir.

First-run behavior: if no directory is configured, download_activity_file returns status: "needs_setup". The assistant will ask where you want to save files (suggesting the current directory as default), call set_fit_download_dir to persist your choice, and then retry the download automatically.

... View full README on GitHub