Garmin Workouts MCP Server

The Garmin Workouts Model Context Protocol (MCP) server connects to Garmin Connect APIs and exposes your fitness and health data to AI agents that support the MCP standard. Users can use this server to access your Garmin activities, workouts, and workout templates from AI clients like Claude Desktop or VS Code Copilot, enabling users to query about their activity data, get insights and get AI generated workout plans.

This project is in early development (v0.1) and currently supports read-only access to activities, workouts, and workout templates.

The source code is a simplified and refactored version of the original Garmin MCP server available at garmin_mcp. The original mcp solution is still available and maintained, but this forked version is designed to reduce the data access surface area to the AI agent and focus on the core features for creating workout training plans rather than exposing all the data and features of the Garmin Connect API.

Garmin’s API is accessed via the python-garminconnect library and also the garth

Features

• List recent activities with pagination support
• Get detailed activity information
• Access workouts and training plans
• Browse workout templates

Usage Examples

Once connected in Claude Desktop/VS Code Copilot, you can ask questions like:

Basic queries:

• “Show me the details of my latest run”
• “Create a workout plan for next week based on my recent activities”
• “When is my next scheduled workout?”
• “Create a workout plan with 30min easy run at conversational pace”
• “Create a workout plan with 5km tempo run at 5:15 min/km pace”
• “Create a workout plan with intervals: 6×400 m @ 4:10–4:20/km, 90s recovery (include 15 min warm-up/cool-down)”

AI Coach assisted queries:

• “What are some workout templates I can use to improve my 5k time?”
• “Based on my recent activities, what workouts should I do this week to prepare for a half marathon?”
• “Create a workout plan for the next Hackney Half Marathon based on my recent activities, with a goal to run it in under 1h45.”
• “Upload a structured 45-minute threshold run workout and schedule it for next Tuesday”
• “Look at my last 4 weeks of running and tell me if I’m overtraining or ready to increase mileage”
• “How much time did I spend in each heart rate zone during my run last Sunday?”
• “Compare my pace and HR across my last 5 runs — am I getting fitter?”
• “I have a race in 6 weeks — build me a progressive weekly workout schedule and add each session to my calendar”

Tool Coverage

This MCP server implements tools for the following domains:

• ✅ Activity Management — 13 read-only tools 🏃
  • 📋 get_activities — list activities with pagination support (newest first)
  • 📅 get_activities_by_date — list activities between two dates, optionally filtered by type