garmin-workouts-mcp

Garmin Workouts MCP

Natural language to Garmin Connect workout creation tool, designed as an MCP (Model Context Protocol) server for Claude.

Installation

Claude Code (Recommended)

claude mcp add garmin-workouts-mcp

Claude Desktop

Add to your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "garmin-workouts-mcp": {
      "command": "npx",
      "args": ["-y", "garmin-workouts-mcp"]
    }
  }
}

Then restart Claude Desktop.

Usage

• Check authentication: "Check my Garmin authentication status"
• Authenticate: "Authenticate with Garmin Connect" (one-time setup)
• Create workouts: "Create a 10 min warmup, 5x1km threshold intervals with 2 min rest, then 10 min cooldown"

Example Workouts

• Easy run: "30 minute easy run in zone 2"
• Intervals: "5x400m at 5k pace with 60 second rest"
• Threshold: "10 min warmup, 20 min tempo in zone 4, 10 min cooldown"
• Sprints: "Warmup 10 min, then 8x15 second sprints with 3 min recovery"
• Complex: "Pyramid workout: 1-2-3-4-3-2-1 minutes hard with equal recovery"

Features

• 🧠 Natural language processing - Describe workouts in plain English
• 🔐 Secure authentication - Token-based auth with automatic renewal
• 🏃 Multi-sport support - Running, cycling, and swimming workouts
• ⚡ Direct Garmin integration - Creates workouts instantly in Garmin Connect
• 💾 Smart caching - Remembers your login, no repeated authentication

How It Works

• Converts your natural language workout description into structured data
• Translates to Garmin's workout API format with proper zones and targets
• Creates the workout directly in your Garmin Connect account
• Syncs automatically to your Garmin device

Made for Claude Code and Claude Desktop.