garmin-connect-mcp

Overview

This MCP server enables LLMs to interact with Garmin Connect through 22 organized tools covering activities, health metrics, training analysis, and more. It supports both UV and Docker installation methods with clear authentication including MFA support. The server provides 3 resources for ongoing context and 6 prompt templates for common queries, making it a comprehensive solution for fitness data analysis.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query-activities

  Query activities with pagination (by ID, date range, or specific date)

  Try:Show me my runs from the last 30 daysTry:Get activities from January 1, 2023
• get-activity-details

  Get comprehensive activity details (splits, weather, HR zones, gear)

  Try:Get details for my half marathon yesterdayTry:Show me metrics for my cycling activity last weekend
• compare-activities

  Compare 2-5 activities side-by-side

  Try:Compare my last three 10K runsTry:Show me differences between my two bike rides this week
• query-health-summary

  Query daily health summaries with pagination

  Try:What's my Body Battery level today?Try:Show me health data for the last week
• query-sleep-data

  Query sleep data with stages, scores, and HRV

  Try:How did I sleep last night?Try:Show my sleep quality for the past month
• analyze-training-period

  Analyze training over a time period with insights

  Try:Analyze my training over the past 30 daysTry:What's my training trend for this month?
• get-user-profile

  Get comprehensive athlete profile with stats and PRs

  Try:Show me my fitness profileTry:What are my personal records?
• query-goals-and-records

  Query goals, personal records, and race predictions

  Try:What are my current fitness goals?Try:Show me my race predictions
• query-devices

  Query device information (with settings, solar data, alarms)

  Try:Show me my connected devicesTry:What's the battery status of my watch?
• query-weight-data

  Query weight data for date or range

  Try:Show my weight for the last monthTry:What's my current weight?
• manage-workouts

  Workout management (list, get, download, upload)

  Try:Show my saved workoutsTry:Download my training plan
• log-health-data

  Log body composition, blood pressure, hydration

  Try:Log my weight for todayTry:Update my blood pressure reading

Comparable tools

Installation

cd garmin-connect-mcp
uv sync

GARMIN_EMAIL=your-email@example.com
GARMIN_PASSWORD=your-password

docker pull ghcr.io/eddmann/garmin-connect-mcp:latest

{
  "mcpServers": {
    "garmin": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/ABSOLUTE/PATH/TO/garmin-connect-mcp",
        "garmin-connect-mcp"
      ]
    }
  }
}

FAQ

Is MFA supported?

Yes, the server supports MFA and will prompt for authentication code when enabled.

How do tokens persist?

OAuth tokens are saved to ~/.garminconnect/ and automatically refreshed. With Docker, mount this directory as a volume.

Compare garmin-connect-mcp with