# Garmin Connect MCP Server

An MCP server that gives Claude access to your Garmin Connect fitness and health data.

## Example usage

- "What were my steps yesterday?"
- "Show me my sleep data for the past week"
- "List my recent running activities"
- "What's my current training status?"

## Installation

```bash
git clone https://github.com/silolis/garmin-connect-mcp.git
cd garmin-connect-mcp
uv sync
```

## Configuration

Add to your Claude settings file:

| Client | Config file location |
|--------|---------------------|
| Claude Desktop (Linux) | `~/.config/claude/claude_desktop_config.json` |
| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Desktop (Windows) | `%APPDATA%\Claude\claude_desktop_config.json` |
| Claude CLI | `~/.claude/settings.json` |

```json
{
  "mcpServers": {
    "garmin-connect": {
      "command": "uv",
      "args": ["--directory", "/path/to/garmin-connect-mcp", "run", "garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "your-email@example.com",
        "GARMIN_PASSWORD": "your-password"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `garmin_get_daily_stats` | Steps, calories, distance, active minutes |
| `garmin_get_heart_rate` | Heart rate data and zones |
| `garmin_get_sleep` | Sleep duration, stages, score |
| `garmin_get_stress` | Stress levels |
| `garmin_get_body_battery` | Body Battery energy |
| `garmin_list_activities` | List activities (with date filtering) |
| `garmin_get_activity_details` | Detailed activity info |
| `garmin_get_weight` | Weight over date range |
| `garmin_get_training_status` | VO2 max, training load |
| `garmin_get_hrv` | Heart rate variability |
| `garmin_get_spo2` | Blood oxygen saturation |

## Acknowledgments

This project is built on [python-garminconnect](https://github.com/cyberjunky/python-garminconnect) that provides comprehensive access to Garmin Connect data. Thanks to the maintainers for their continued work on this invaluable tool.

## License

MIT License - see [LICENSE](LICENSE)