Garmin MCP

🚀 Garmin MCP Server

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

🚀 Quick Start

This server connects to Garmin Connect and enables sharing of your fitness and health data with Claude and other compatible clients.

✨ Features

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

📦 Installation

1. Install the required packages in a new environment:

virtualenv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

2. Create a .env file in the project root directory and enter your Garmin credentials:

GARMIN_EMAIL=your.email@example.com
GARMIN_PASSWORD=your-password

💻 Usage

Using 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": "python", // If you created a new environment, this should be "<root directory>/.venv/bin/python"
      "args": ["<path>/garmin_mcp/garmin_mcp_server.py"]
    }
  }
}

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

2. Restart Claude Desktop

Testing with MCP Inspector

For testing, you can use the MCP Inspector:

npx @modelcontextprotocol/inspector python /Users/adomingues/Documents/claude_filesystem/garmin_mcp/garmin_mcp_server.py

💻 Usage Examples

Once successfully connected in Claude, you can ask the following questions:

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

⚠️ Important Note

This server requires your Garmin Connect credentials in the .env file. Keep this file secure and never commit it to the version control system.

🔧 Troubleshooting

If you encounter login issues:

1. Confirm that the credentials in the .env file are correct.
2. Check if Garmin Connect requires additional verification.
3. Ensure that the garminconnect package is up to date.

For other issues, check the Claude Desktop logs:

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