garmin_mcp

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.

• List recent activities with pagination support
• Get detailed activity information
• Edit activities: name, type, description/notes, event type, perceived effort (RPE), and feel
• 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
• 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

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

• ✅ Activity Management (20 tools) - includes write tools for type, description, event type, perceived effort, and feel
• ✅ Health & Wellness (31 tools) - includes custom lightweight summary tools
• ✅ Training & Performance (13 tools) - includes CTL/ATL/TSB, HRV, VO2 max, and respiration trends
• ✅ Workouts (8 tools)
• ✅ Devices (7 tools)
• ✅ Gear Management (5 tools)
• ✅ Weight Tracking (5 tools)
• ✅ Challenges & Badges (10 tools)
• ✅ Nutrition (8 tools) - food logs, meals, custom foods, and food logging
• ✅ Women's Health (3 tools)
• ✅ User Profile (3 tools)
• ✅ High-Level Workout Builders (4 tools) - create and schedule workouts without writing JSON
• ✅ Courses (3 tools) - list / upload GPX as course / 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.

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.