Model Context Protocol (MCP) server for Garmin Connect
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"rmc-garmin-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Garmin Connect MCP Server Languages: [English](README.md) | [日本語 (Japanese)](doc/README/JA.md) | [简体中文 (Simplified Chinese)](doc/README/ZH.md) A Model Context Protocol (MCP) server designed to retrieve daily health, fitness, and activity statistics from Garmin Connect and expose them to Large Language Models (LLMs). Built on Python's `FastMCP`, this server features robust authentication token persistence to protect your Garmin Connect account from being locked due to repeated login requests. --- ## Features - **Token Session Persistence Cache**: The Garmin Connect API frequently locks accounts if too many login requests are made in a short time. This server automatically caches your session tokens locally (defaults to `~/.garminconnect` or configured path) upon the first successful login, reusing them for subsequent requests. - **15 Rich Data Tools**: Access steps, heart rate, sleep scores, stress, hydration, respiration, SpO2, body composition (weight/body fat), activity history, connected devices, and more. - **Strict Type Safety & Testing**: Fully compliant with `mypy --strict` and `ruff`, with a comprehensive mock-based test suite. --- ## Setup Instructions ### Prerequisites - Python 3.12 or higher - [uv](https://github.com/astral-sh/uv) (fast Python package and project manager) ### 1. Installation Clone this repository and install it in editable mode: ```bash git clone https://github.com/rmc8/rmc_garmin_mcp.git cd rmc_garmin_mcp uv pip install -e . ``` ### 2. Environment Configuration Copy `.env.example` to create a `.env` file and configure your Garmin credentials: ```bash cp .env.example .env ``` Edit the `.env` file: ```env # Garmin Connect Login Email GARMIN_EMAIL=your_email@example.com # Garmin Connect Login Password GARMIN_PASSWORD=your_password # (Optional) Change the token directory path # GARMINTOKENS=/path/to/tokens ``` ### 3. Multi-Factor Authentication (MFA) Setup (Optional) If your Garmin Connect account has MFA (Multi-Factor A…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.