Skip to main content
Glama

Slurp garmin-mcp

An MCP server for Garmin Connect. It gives Claude and other MCP clients access to your activities, health data, training metrics, workouts, nutrition, gear and calendar: more than 150 tools, about a third of which can also change things.

It runs locally next to a desktop client, or as a service on a server (systemd or Docker) for claude.ai and other remote clients.

Not affiliated with Garmin. Garmin Connect has no public API for personal use; this server uses the same endpoints as the Garmin Connect website, through python-garminconnect. Those endpoints can change without notice.

Quick start (local)

Needs Python 3.10 or newer and uv.

# 1. Log in to Garmin once (asks for your MFA code if enabled)
uvx --from git+https://github.com/rvartanov/slurp-garmin-mcp garmin-mcp-auth

# 2. Add the server to your client, for example Claude Code:
claude mcp add garmin -- uvx --from git+https://github.com/rvartanov/slurp-garmin-mcp garmin-mcp

Claude Desktop, in claude_desktop_config.json:

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/rvartanov/slurp-garmin-mcp", "garmin-mcp"]
    }
  }
}

No password goes into the client configuration; the server uses the tokens saved in step 1.

Related MCP server: garmin-mcp

Quick start (server)

git clone https://github.com/rvartanov/slurp-garmin-mcp
sudo slurp-garmin-mcp/deploy/install.sh     # systemd service, prints the next steps

or with Docker:

mkdir -p secrets && openssl rand -hex 32 > secrets/url_secret.txt && chmod 644 secrets/url_secret.txt
docker compose run --rm --entrypoint garmin-mcp-auth garmin-mcp
docker compose up -d

Put a reverse proxy or tunnel with TLS in front and add https://<your host>/<secret>/mcp as a custom connector in Claude. The full steps are in docs/deployment.md.

Things to ask

  • "Show me my recent activities"

  • "What was my sleep like last night?"

  • "Show my training load and HRV trend for the last six weeks"

  • "Create a 5 x 1 km interval workout and schedule it for Thursday"

  • "Which races are on my Garmin calendar?"

Documentation

Installation

pip, uv and uvx; first login and MFA; several accounts; garmin.cn

Clients

Claude.ai custom connector, Claude Desktop, Claude Code, Codex, opencode, others

Deployment

systemd, Docker, reverse proxy, Tailscale Funnel

Configuration

every environment variable; tool profiles and allow/deny lists

Security

tokens, bearer token, URL secret, hardening

Tools

all tools, generated from the code

Workout tools

the workout builders and the raw workout format

Tool notes

gear, file downloads, strength sets, skipped endpoints

Troubleshooting

login, MFA, known Garmin quirks, logs

Changelog · Contributing · Security policy

Credits

Slurp garmin-mcp is a fork of Taxuspt/garmin_mcp by Alexandre Domingues and its contributors, who built the server and nearly all of its tools. This fork adds packaging as a standalone service (URL-secret mode, secret files, systemd and Docker deployment) and its own documentation; see NOTICE and the changelog.

Garmin Connect access is provided by python-garminconnect by cyberjunky.

License

MIT. Copyright (c) 2025 Alexandre Domingues, Copyright (c) 2026 Robert Vartanov.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides access to Garmin Connect fitness, health, and training data through 61 specialized tools. It enables users to query activities, sleep metrics, and performance stats directly within AI clients like Claude or Cursor.
      97
      238 npm
      191
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to access and query your Garmin Connect data, including sleep, activities, training load, and health metrics, through a set of read-only MCP tools.
      28
      154 PyPI
      5
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables Claude and other MCP clients to query Garmin Connect health, training, activity, and body data, analyze FIT files, and create structured workouts that sync to a Garmin watch.
      39
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables users to query their own Garmin Connect data—such as recovery, sleep, HRV, activities, and daily wellness—through a read-only remote MCP connection secured with OAuth, including from the Claude mobile app.
      MIT