Garmin MCP

Connect to Garmin Connect and access your fitness and health data through Claude and other MCP-compatible clients. Built on the python-garminconnect library, this server provides comprehensive access to your Garmin ecosystem.

Features

Core Capabilities

• Activity Management: List recent activities with pagination, get detailed activity information, manage activity names
• Health Metrics: Access steps, heart rate, sleep, stress, and respiration data
• Body Composition: Track weight and body composition measurements
• Training Analytics: Monitor training status, readiness, cycling FTP, and lactate threshold
• Gear Management: Track and manage equipment and gear
• Workouts & Plans: Access workouts, training plans, and detailed workout structures including repeat groups and swim pace targets
• Weekly Aggregates: View weekly summaries of steps, stress, and intensity minutes

Advanced Analytics

• Cycling Analytics: Power zones, FIT file analysis, Shimano Di2 electronic shift intelligence
• Training Load: CTL (Chronic Training Load), ATL (Acute Training Load), TSB (Training Stress Balance) trends
• Performance Trends: HRV trend, VO2 max trend, respiration rate trend
• Power Analysis: Power Duration Curve, climb detection with VAM, cardiac drift (aerobic decoupling), W/kg calculations

High-Level Workout Builders

Create and schedule workouts without writing JSON:

• create_walk_run_workout: Interval workouts with optional heart-rate zone targets
• create_z2_walk_workout: Steady Z2 walking workouts
• create_strength_workout: Strength workouts from exercise lists
• schedule_week: Schedule multiple workouts in one call

Tool Coverage

Implements 110+ tools covering ~90% of the python-garminconnect library:

• ✅ Activity Management (15 tools)
• ✅ Health & Wellness (31 tools)
• ✅ Training & Performance (13 tools)
• ✅ Workouts (8 tools)
• ✅ Devices (7 tools)
• ✅ Gear Management (5 tools)
• ✅ Weight Tracking (5 tools)
• ✅ Challenges & Badges (10 tools)
• ✅ Nutrition (8 tools)
• ✅ Women's Health (3 tools)
• ✅ User Profile (3 tools)
• ✅ High-Level Workout Builders (4 tools)
• ✅ Courses (3 tools)
• ✅ Activity Analysis (2 tools)

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.

Authentication

Important: You must authenticate once before the server can access your data:

uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth

This saves OAuth tokens to ~/.garminconnect. Tokens are valid for approximately 6 months.

Multi-Factor Authentication (MFA)

If MFA is enabled on your Garmin account, you'll be prompted for your MFA code during authentication. The pre-authentication tool handles this interactively.

Garmin Connect China

For Garmin Connect China (garmin.cn) users:

GARMIN_IS_CN=true garmin-mcp-auth
# or
garmin-mcp-auth --is-cn

Usage Examples

Once connected, ask questions like:

• "Show me my recent activities"
• "What was my sleep like last night?"
• "How many steps did I take yesterday?"
• "Show me the details of my latest run"
• "Analyze my last ride's power zones and compare to my training zones"
• "Show me my CTL, ATL, and TSB trend for the last 6 weeks"
• "What was my power duration curve from yesterday's ride? Estimate my FTP."
• "Analyze the FIT data from my last cycling activity — how was my shifting quality on the climbs?"
• "Show me my HRV trend for the last 2 weeks and flag any recovery concerns"
• "What's my season best 20-minute power and when did I set it?"

Testing

Comprehensive test suite with 200+ integration tests and end-to-end tests. All tests currently passing (100%).