Garmin MCP Server

This Model Context Protocol (MCP) server connects to Garmin Connect and exposes your fitness and health data to Claude and other MCP-compatible clients.

Features

• List recent activities
• Get detailed activity information
• Access health metrics (steps, heart rate, sleep)
• View body composition data

Setup

1. Install the required packages on a new environment:

uv sync

Running the Server

Configuration

Your Garmin Connect credentials are read from environment variables:

• GARMIN_EMAIL: Your Garmin Connect email address
• GARMIN_EMAIL_FILE: Path to a file containing your Garmin Connect email address
• GARMIN_PASSWORD: Your Garmin Connect password
• GARMIN_PASSWORD_FILE: Path to a file containing your Garmin Connect password

File-based secrets are useful in certain environments, such as inside a Docker container. Note that you cannot set both GARMIN_EMAIL and GARMIN_EMAIL_FILE, similarly you cannot set both GARMIN_PASSWORD and GARMIN_PASSWORD_FILE.

With Claude Desktop

1. Create a configuration in Claude Desktop:

Edit your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this server configuration:

{
  "mcpServers": {
    "garmin": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/Taxuspt/garmin_mcp",
        "garmin-mcp"
      ],
      "env": {
        "GARMIN_EMAIL": "YOUR_GARMIN_EMAIL",
        "GARMIN_PASSWORD": "YOUR_GARMIN_PASSWORD"
      }
    }
  }
}

Replace the path with the absolute path to your server file.

2. Restart Claude Desktop

With MCP Inspector

For testing, you can use the MCP Inspector from the project root:

npx @modelcontextprotocol/inspector uv run garmin-mcp

Usage Examples

Once connected in Claude, you can ask questions like:

• "Show me my recent activities"
• "What was my sleep like last night?"
• "How many steps did I take yesterday?"
• "Show me the details of my latest run"

Security Note

Troubleshooting

If you encounter login issues:

1. Verify your credentials are correct
2. Check if Garmin Connect requires additional verification
3. Ensure the garminconnect package is up to date

For other issues, check the Claude Desktop logs at:

• macOS: ~/Library/Logs/Claude/mcp-server-garmin.log
• Windows: %APPDATA%\Claude\logs\mcp-server-garmin.log