home / mcp / garmin mcp server

Garmin MCP Server

Provides a server to interact with Garmin Connect API, enabling token handling, server inspection, and MCP registration for Garmin data management.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dshvadskiy-garmin_mcp": {
      "command": "mcp",
      "args": [
        "dev",
        "garmin_mcp_server.py"
      ],
      "env": {
        "GARMIN_EMAIL": "[email protected]",
        "GARMIN_PASSWORD": "your_password"
      }
    }
  }
}

This MCP server provides a dedicated interface to interact with the Garmin Connect API, letting you manage workouts, health metrics, and other Garmin data through a command-line driven MCP workflow. It streamlines token generation, server inspection, and explicit MCP server registration for seamless use with MCP clients.

How to use

You can operate the Garmin MCP Server with an MCP client to inspect, configure, and run the server locally. First generate your Garmin Connect token, then use the MCP Inspector to run and test the server, and finally register it so you can manage it through your MCP environment.

Steps you will typically perform:

1) Generate your token for Garmin Connect:

python example.py

2) Inspect and run the MCP server locally using the MCP client to verify it starts correctly:

mcp dev garmin_mcp_server.py

3) Register the MCP server so it becomes available in your MCP environment:

mcp install garmin_mcp_server.py

After these steps, you can connect to the Garmin MCP Server with your MCP client and perform data operations through Garmin Connect as supported by the server.

How to install

Prerequisites you need before starting the setup:

Python 3.x installed
Required Python packages installed via uv sync
A Garmin Connect account
Access to a Garmin Connect token flow via the provided script

Environment setup involves creating a configuration file to store credentials securely.

[email protected]
GARMIN_PASSWORD=your_password

Then generate the token using the provided script and proceed to run the MCP commands:

python example.py
```
```
mcp dev garmin_mcp_server.py
```
```
mcp install garmin_mcp_server.py

Additional sections

Configuration notes: Ensure you place your Garmin Connect credentials in a secure location. The token generation script will use these credentials to obtain access to Garmin Connect and enable data operations through the MCP server.

Security considerations: Treat the Garmin Connect credentials as sensitive data. Do not commit your .env or credentials to version control. Use environment management practices to limit access.

Troubleshooting tips: If you encounter authentication failures, re-check your GARMIN_EMAIL and GARMIN_PASSWORD values and re-run the token generation step. If the MCP Inspector reports startup issues, verify that the garmin_mcp_server.py file is accessible and that the MCP CLI is installed and up to date.