Skip to main content
Glama
Garmin Connect MCP Server

Garmin Connect MCP Server

by Ezhil2k

Garmin MCP

Read Garmin Connect health, activity, profile, device, and body-battery data through:

  • a simple local CLI/dashboard;

  • an MCP server for ChatGPT or another MCP client.

The MCP server also exposes per-distance/per-lap splits for individual activities.

Garmin MCP dashboard

The MCP tools are read-only. Garmin login tokens are cached locally in ~/.garminconnect; never commit .env or token files.

Run

source .venv/bin/activate
./garmin-mcp

The dashboard starts the MCP server and secure tunnel in the background. Use:

r  start services
x  stop services
s  refresh status
l  show logs
q  quit dashboard

For one-off commands:

./garmin-mcp status
./garmin-mcp test
./garmin-mcp doctor

Related MCP server: GARMIN Connect MCP

ChatGPT MCP connection

The dashboard must show both services as running/ready/connected. In ChatGPT, add a custom MCP connector using the configured tunnel ID. The tunnel forwards ChatGPT to the local endpoint:

http://127.0.0.1:8000/mcp

If the tunnel or MCP process stops, ChatGPT cannot reach Garmin until the dashboard is started again.

First login and configuration

On the first Garmin request, enter the Garmin email/password when prompted. Credentials and tunnel settings may be placed in a local .env file; copy .env.example and fill it in. Keep .env private.

Useful direct commands

./garmin-mcp run
python mcp_server.py --transport streamable-http

The server listens locally on 127.0.0.1:8000 and exposes /mcp.

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

    • F
      license
      A
      quality
      D
      maintenance
      Provides read-only access to your Garmin Connect health data, including sleep, HRV, body battery, stress, training readiness, and activities, through an MCP server.
      2
      14
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives any MCP client local access to Garmin Connect sleep and nap data, recovery and Body Battery, training readiness and load, running tolerance, VO2 Max, race predictions, gear mileage and running summaries. It runs over stdio or Streamable HTTP and includes a credential-free demo mode with fictional sample data.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables local, read-only access to Garmin Connect training and wellness data, including activities, sleep, HRV, and daily summaries, for client-side analysis through stdio.
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables read-only access to the official Garmin Connect Personal API so users can explore activities, workouts, and health metrics such as sleep, HRV, stress, and Body Battery through MCP clients over stdio or local Streamable HTTP.
      6
      MIT