Garmin MCP Server

A read-only MCP server that lets an AI agent query your own Garmin Connect data through Garmin's official Personal API.

1. Create a personal API key

1. Sign in to Garmin Connect Web and open https://connect.garmin.com/app/settings/personalApiToken.

2. Create Key, accept the terms, pick an expiry (30 days – 1 year), and copy the key. It is shown only once — treat it like a password.

The server exchanges the key for a 24-hour access token and renews it automatically. When the key itself expires (Garmin emails you a week ahead), create a new one and update your config.

Related MCP server: garth-mcp-server

2. Install and verify

Requires uv and Python 3.11+.

cd c:\temp\garmin-mcp-server
uv sync

Check the key works (prints only field counts, no personal data):

$env:GARMIN_PERSONAL_API_KEY = "<your key>"; uv run garmin-mcp check

3. Connect an MCP client

Claude Code

claude mcp add garmin --scope user -e GARMIN_PERSONAL_API_KEY=<your key> -- uv --directory c:\temp\garmin-mcp-server run garmin-mcp

Then run /mcp in Claude Code to confirm garmin is connected.

Any other MCP client (stdio)

Most clients accept a JSON server entry like this:

{
  "mcpServers": {
    "garmin": {
      "command": "uv",
      "args": ["--directory", "c:\\temp\\garmin-mcp-server", "run", "garmin-mcp"],
      "env": { "GARMIN_PERSONAL_API_KEY": "<your key>" }
    }
  }
}

Tools

All tools are read-only. Dates are YYYY-MM-DD; a missing date means today. Ranged tools accept up to 366 days and split requests to fit Garmin's per-call limits (28/31 days). Tools marked † drop large intraday time series unless called with include_samples=true.

Not available in the Personal API (so not offered here): training readiness, training status, VO2 max, personal records, and device lists.

Security notes

• The key is read only from the GARMIN_PERSONAL_API_KEY environment variable and is never logged or included in error messages.

• Revoke access at any time by deleting the key on Garmin Connect Web.

• The Personal API is licensed for personal use with your own data only.

Development

uv run pytest

License

Licensed under the Apache License 2.0.