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
• Access health metrics (steps, heart rate, sleep, stress, respiration)
• View body composition data
• Track training status and readiness
• Manage gear and equipment
• Access workouts and training plans
• Weekly health aggregates (steps, stress, intensity minutes)

Tool Coverage

This MCP server implements 96+ tools covering ~89% of the python-garminconnect library (v0.2.38):

• ✅ Activity Management (14 tools)
• ✅ Health & Wellness (31 tools) - includes custom lightweight summary tools
• ✅ Training & Performance (9 tools)
• ✅ 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)

Intentionally Skipped Endpoints

Some endpoints are not implemented due to performance or complexity considerations:

High Data Volume:

• get_activity_details() - Returns large GPS tracks and chart data (50KB-500KB). Use get_activity() for summaries instead.

Specialized Workout Formats:

• upload_running_workout(), upload_cycling_workout(), upload_swimming_workout() - Sport-specific workout uploads. Use upload_workout() for general workouts.

Maintenance & Destructive Operations:

• delete_activity(), delete_blood_pressure() - Destructive operations require careful consideration.
• Internal/Auth methods: login(), resume_login(), connectapi(), download() - Handled automatically by the library.

If you need any of these endpoints, please open an issue.

Setup

Quick Start for Claude Desktop

The easiest way to use this MCP server with Claude Desktop is to authenticate once before adding the server to your configuration.

Prerequisites

• Python 3.12+
• Garmin Connect account
• MFA may be required if enabled on your account

Step 1: Pre-authenticate (One-time)

Before adding to Claude Desktop, authenticate once in your terminal:

# Install and run authentication tool
uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth

# You'll be prompted for:
# - Email (or set GARMIN_EMAIL env var)
# - Password (or set GARMIN_PASSWORD env var)
# - MFA code (if enabled on your account)

# OAuth tokens will be saved to ~/.garminconnect

You can verify your credentials at any time with

uv run garmin-mcp-auth --verify

Note: You can also set credentials via environment variables:

GARMIN_EMAIL=your@email.com GARMIN_PASSWORD=secret garmin-mcp-auth

If you don't have MFA enabled you can also skip garmin-mcp-auth and pass GARMIN_EMAIL and GARMIN_PASSWORD as env variables directly to Claude Desktop (or other MCP client, if supported), see below for an example.

Step 2: Configure Claude Desktop

Add to your Claude Desktop MCP settings WITHOUT credentials:

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

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ]
    }
  }
}

Important: No GARMIN_EMAIL or GARMIN_PASSWORD needed in config! The

... View full README on GitHub