{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_arywuu3zeahv","handle":"rmc-garmin-mcp","url":"https://wellknown.network/agents/rmc-garmin-mcp","links":{"self":"https://wellknown.network/agents/rmc-garmin-mcp/record.json","html":"https://wellknown.network/agents/rmc-garmin-mcp","markdown":"https://wellknown.network/agents/rmc-garmin-mcp/record.md","api":"https://wellknown.network/api/v1/agents/rmc-garmin-mcp","status":"https://wellknown.network/api/v1/agents/rmc-garmin-mcp/status","claim":"https://wellknown.network/agents/rmc-garmin-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/rmc-garmin-mcp/claim.json","badge":"https://wellknown.network/agents/rmc-garmin-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/rmc-garmin-mcp/history","tools":"https://wellknown.network/api/v1/agents/rmc-garmin-mcp/tools"},"ard":{"identifier":"urn:air::server:rmc-garmin-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"rmc-garmin-mcp","summary":"Model Context Protocol (MCP) server for Garmin Connect","description":"# Garmin Connect MCP Server\n\nLanguages: [English](README.md) | [日本語 (Japanese)](doc/README/JA.md) | [简体中文 (Simplified Chinese)](doc/README/ZH.md)\n\nA 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).\nBuilt 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.\n\n---\n\n## Features\n\n- **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.\n- **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.\n- **Strict Type Safety & Testing**: Fully compliant with `mypy --strict` and `ruff`, with a comprehensive mock-based test suite.\n\n---\n\n## Setup Instructions\n\n### Prerequisites\n\n- Python 3.12 or higher\n- [uv](https://github.com/astral-sh/uv) (fast Python package and project manager)\n\n### 1. Installation\n\nClone this repository and install it in editable mode:\n\n```bash\ngit clone https://github.com/rmc8/rmc_garmin_mcp.git\ncd rmc_garmin_mcp\nuv pip install -e .\n```\n\n### 2. Environment Configuration\n\nCopy `.env.example` to create a `.env` file and configure your Garmin credentials:\n\n```bash\ncp .env.example .env\n```\n\nEdit the `.env` file:\n```env\n# Garmin Connect Login Email\nGARMIN_EMAIL=your_email@example.com\n# Garmin Connect Login Password\nGARMIN_PASSWORD=your_password\n\n# (Optional) Change the token directory path\n# GARMINTOKENS=/path/to/tokens\n```\n\n### 3. Multi-Factor Authentication (MFA) Setup (Optional)\nIf your Garmin Connect account has MFA (Multi-Factor A…","publisher":{"name":"rmc8","url":null},"homepage":"https://github.com/rmc8/rmc_garmin_mcp","repository":"https://github.com/rmc8/rmc_garmin_mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:rmc-garmin-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"rmc-garmin-mcp","registry":"pypi","observedAt":"2026-11-03T23:23:03.562Z","publishedAt":"2026-07-05T03:00:12.803422Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"rmc-garmin-mcp","url":"https://pypi.org/project/rmc-garmin-mcp/","firstSeenAt":"2026-09-10T11:27:11.403Z","fetchedAt":"2026-11-03T23:22:20.442Z","normalizedAt":"2026-11-03T23:22:20.442Z"}]},"firstSeenAt":"2026-09-10T11:27:11.403Z","updatedAt":"2026-11-03T23:23:03.562Z"}