Garmin Mcp Server

Garmin Connect MCP Server

A Model Context Protocol (MCP) server that exposes your Garmin Connect health and fitness data to AI assistants. Ask your AI about your sleep, heart rate, workouts, stress, body battery, and more.

Features

• 34 tools covering health metrics, activities, trends, and comparisons
• Streamable HTTP transport — works with any MCP-compatible client
• Docker-ready — one command to build and run
• Token persistence — authenticate once with Garmin, tokens last ~1 year
• MFA support — handles SMS two-factor authentication
• Parallel data fetching — weekly reports pull 7+ days of data concurrently
• Imperial units — distances converted to miles automatically

Quick Start

Option 1: Docker (Recommended)

# 1. Authenticate with Garmin (one-time)
pip install 'garminconnect>=0.2.20, **Note on `garminconnect` version:** `requirements.txt` pins to `=0.3.0`, which dropped the `garth` attribute this repo uses. Downgrade with `pip install 'garminconnect>=0.2.20,<0.3'`.

**Empty data for some metrics:** Your Garmin device may not track that metric, or data hasn't synced yet.

**Connection refused:** Make sure the server is running and port 8000 is accessible. For Docker, check `docker compose logs`.

## Built With

- [FastMCP](https://github.com/jlowin/fastmcp) — MCP server framework
- [garminconnect](https://github.com/cyberjunky/python-garminconnect) — Garmin Connect API client

## License

MIT — see [LICENSE](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bmccarn](https://github.com/bmccarn)
- **Source:** [bmccarn/garmin-mcp-server](https://github.com/bmccarn/garmin-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.