Garmin Connect MCP Server
Provides read-only access to a user's Garmin Connect personal data via the Garmin Connect Personal API, including activities and FIT streams, sleep, HRV, Body Battery, stress, steps, weight, profile settings, and daily wellness summaries. It exposes tools for querying summaries over custom time ranges, retrieving activity details, and accessing raw Garmin Connect GET endpoints.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Garmin Connect MCP Server How did I sleep last night, and what's my Body Battery today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Garmin Connect MCP Server
Ein Model Context Protocol Server für deine eigenen Garmin-Connect-Daten über die Garmin Connect Personal API: Aktivitäten samt FIT-Verläufen, Schlaf, HRV, Body Battery, Stress, Gewicht und Tageswerte. Der Zugriff ist read-only.
Dazu gehört ein optionales Claude-Plugin mit Analyse-Skills für Tagesform, Wochenreview, Rennen, Laufbelastung, Unihockey, Ironman sowie Ultra und Trail.
Tools
Tool | Inhalt | Standard-Zeitraum |
| Profil-Einstellungen und HF-Zonen | – |
| Schritte, Kalorien, Ruhepuls, Stress, Body Battery, Intensitätsminuten | 7 Tage |
| Schlaf pro Nacht inkl. Score | 14 Tage |
| HRV pro Nacht, Baseline, Status | 28 Tage |
| Body Battery pro Tag | 7 Tage |
| Tageswerte | 28 Tage |
| Gewicht / Körperzusammensetzung | 90 Tage |
| Wellness-Aktivität pro Tag | 7 Tage |
| Detail eines Tages | heute |
| Fitness-Alter, SpO2 | heute |
| Aktivitäten kompakt (Distanz, Pace, HF, Trainingseffekt, Load) | 30 Tage |
| Volle Details einer Aktivität | – |
| FIT-Datei → Session, Laps, Verlauf (HF, Pace, Leistung, Kadenz, Höhe) | – |
| Beliebiger GET-Endpoint aus der Swagger-Doku | – |
Lange Zeitreihen werden standardmässig gekürzt, damit der Chat-Kontext nicht vollläuft. Mit include_timeseries=true bekommst du die Rohdaten.
API-Key
Erstelle unter https://connect.garmin.com/app/settings/personalApiToken einen Key mit Create Key. Er wird nur einmal angezeigt und läuft nach der gewählten Dauer ab (30 Tage bis 1 Jahr). Der Server liest ihn aus der Umgebungsvariable GARMIN_PERSONAL_API_KEY.
Related MCP server: mcp-garmin
Installation
Claude Desktop (Extension, empfohlen)
Lade
garmin-connect.mcpbaus dem neuesten Release herunter und doppelklicke die Datei.Trag den API-Key im Konfigurationsdialog ein. Er ist danach unter Einstellungen → Extensions → Garmin Connect sichtbar und änderbar.
Python und die Abhängigkeiten installiert Claude Desktop selbst.
Mit uvx (jeder MCP-Client)
Voraussetzung ist uv. Das Paket wird beim Start automatisch von PyPI geladen.
{
"mcpServers": {
"garmin": {
"command": "uvx",
"args": ["mcp-server-garmin-connect"],
"env": { "GARMIN_PERSONAL_API_KEY": "<dein-key>" }
}
}
}In Claude Code genügt ein Befehl:
claude mcp add garmin -e GARMIN_PERSONAL_API_KEY=<dein-key> -- uvx mcp-server-garmin-connectMit pip
pip install mcp-server-garmin-connect
GARMIN_PERSONAL_API_KEY=<dein-key> mcp-server-garmin-connectMit Docker
docker build -t mcp-server-garmin-connect .
docker run -i --rm -e GARMIN_PERSONAL_API_KEY=<dein-key> mcp-server-garmin-connectSkills (optional, Claude)
Füge den Plugin-Marketplace https://github.com/flawas/garmin-mcp hinzu und installiere das Plugin garmin-connect. In Claude Code geht das mit /plugin install garmin-connect --marketplace flawas/garmin-mcp.
Skill | Wofür |
| Tagesform-Ampel aus HRV, Schlaf, Ruhepuls und Body Battery mit Empfehlung für heute |
| Wochenbericht nach Sportart, optional als Obsidian-Notiz |
| Taper- und Formcheck, realistische Zielzeit, Pacing-Plan |
| Rennanalyse: Splits, Einbruch, HF-Drift, Kadenz, Lehren |
| Laufumfang, Steigerungsrate, ACWR, Verletzungsrisiko |
| Unihockey (bei Garmin als Feldhockey erfasst) als Intervallbelastung einordnen |
| Triathlon-Aufbau: Verteilung, Langeinheiten, Koppeltrainings, Lücken |
| Time on Feet, Höhenmeter, Kilometer-Effort, Ermüdungsresistenz |
| Allgemeine Analysen und Basis für alle anderen Skills |
Konfiguration
Variable | Pflicht | Bedeutung |
| ja | Personal API Key |
| nein | Ordner für Token-Cache und FIT-Downloads. Standard ist |
Debugging
Mit dem MCP Inspector:
npx @modelcontextprotocol/inspector uvx mcp-server-garmin-connect
# aus dem Repo heraus:
npx @modelcontextprotocol/inspector uv run mcp-server-garmin-connectMeldung | Lösung |
| Neuen Key erstellen und in der Extension bzw. in |
| Internetverbindung, VPN oder Proxy prüfen |
Entwicklung
uv sync # Umgebung inkl. Dev-Tools
uv run pytest # Tests
uv run ruff check . && uv run ruff format --check .
uv run pyright # Typen
npx @anthropic-ai/mcpb pack . garmin-connect.mcpb # Desktop Extension lokal bauenAufbau des Repos:
src/mcp_server_garmin_connect/ MCP-Server (Python-Paket, Einstiegspunkt mcp-server-garmin-connect)
tests/ pytest
server.json Eintrag für die MCP Registry
manifest.json, .mcpbignore Claude Desktop Extension (.mcpb)
.claude-plugin/, skills/ Claude-Plugin mit Analyse-Skills
.github/workflows/ CI und ReleaseRelease
Die Version in
pyproject.toml,manifest.jsonundserver.json(zweimal: oben und im PyPI-Paket) gleich setzen. Die CI prüft das. Bei Skill-Änderungen zusätzlich.claude-plugin/plugin.jsonerhöhen.git tag v<version> && git push origin v<version>Der Release-Workflow testet, baut, veröffentlicht auf PyPI, erstellt das GitHub-Release mit der
.mcpb, trägt deren SHA-256 inserver.jsonein und veröffentlicht in der MCP Registry.
Vor dem ersten Release ist eine einmalige Einrichtung nötig:
PyPI Trusted Publishing: Auf https://pypi.org/manage/account/publishing/ einen pending publisher anlegen mit PyPI-Projekt
mcp-server-garmin-connect, Ownerflawas, Repositorygarmin-mcp, Workflowrelease.ymlund Environmentpypi.GitHub: In den Repo-Einstellungen unter Environments das Environment
pypianlegen.Für die MCP Registry ist nichts einzurichten. Die Anmeldung läuft über GitHub OIDC für den Namensraum
io.github.flawas.
Hinweis
Die Garmin Connect Personal API ist für den persönlichen Zugriff auf die eigenen Daten gedacht, nicht für kommerzielle Anwendungen mit mehreren Nutzern. Dieses Projekt steht in keiner Verbindung zu Garmin.
Lizenz
MIT, siehe LICENSE.
Available Tools
19 toolsactivity_detailsC
Vollständige Zusammenfassung einer Aktivität (Splits-Summary, Trainingseffekt, Gerät usw.).
Inputs: activity_id (required).
activity_streamsA
Lädt die Original-FIT-Datei und liefert Session-Werte, alle Laps und einen auf
resolution_seconds heruntergerechneten Verlauf (HF, Pace/Speed, Leistung, Kadenz, Höhe).
Ideal für Intervall-, Pacing-, Drift- und Zonen-Analysen. Datei wird lokal gecacht.
Inputs: activity_id (required), resolution_seconds.
activity_workoutsC
Geplante/strukturierte Workouts, die mit einer Aktivität verknüpft sind.
Inputs: activity_id (required).
body_batteryB
Body Battery pro Tag (Aufladung, Verbrauch, Höchst-/Tiefstwert). Standard: letzte 7 Tage.
Inputs: end_date, start_date.
daily_summariesB
Tageszusammenfassungen pro Tag: Schritte, Kalorien, Ruhepuls, Stress, Body Battery, Intensitätsminuten, Etagen usw. Standard: letzte 7 Tage.
Inputs: end_date, start_date.
fitness_ageD
Fitness-Alter und beeinflussende Faktoren.
Inputs: date.
heart_rate_dayC
Herzfrequenz eines Tages (Ruhepuls, Min/Max; Verlauf nur mit include_timeseries=true).
Inputs: date, include_timeseries.
hrv_dayB
HRV einer Nacht mit Einzelmessungen (Zeitreihe nur mit include_timeseries=true).
Inputs: date, include_timeseries.
hrv_summariesA
HRV pro Nacht (Mittelwert, 7-Tage-Schnitt, Baseline, Status). Standard: letzte 28 Tage.
Inputs: end_date, start_date.
list_activitiesA
Aktivitäten (kompakt) im Zeitraum, neueste zuerst. Standard: letzte 30 Tage.
activity_type z.B. running, cycling, trail_running, lap_swimming, strength_training.
Für mehr als limit Einträge mit start paginieren.
Inputs: limit, start, end_date, start_date, +1 more.
profileC
Profil-Einstellungen (Gewicht, Grösse, VO2max, Laktatschwelle, Einheiten) und Herzfrequenzzonen.
Inputs: no named parameters.
raw_getB
Beliebiger GET-Aufruf an die Personal API für Endpoints ohne eigenes Tool (siehe Swagger-Doku), z.B. path='/usersummary-service/stats/hydration/daily/2026-10-01/2026-10-21'.
Inputs: path (required), params, include_timeseries.
sleep_dayA
Detaillierter Schlaf einer Nacht (Phasen, Atmung, HF, HRV, Sleep Score inkl. Faktoren).
date = Datum des Aufwachens. Zeitreihen nur mit include_timeseries=true.
Inputs: date, include_timeseries.
sleep_summariesA
Schlaf-Zusammenfassung pro Nacht (Dauer, Phasen, Sleep Score). Standard: letzte 14 Tage.
Inputs: end_date, start_date.
spo2_dayC
Pulsoximetrie (SpO2) und Höhenakklimatisierung eines Tages.
Inputs: date.
stepsB
Schritte und Schrittziel pro Tag. Standard: letzte 28 Tage.
Inputs: end_date, start_date.
stressB
Durchschnittlicher Stress pro Tag. Standard: letzte 28 Tage.
Inputs: end_date, start_date.
weightC
Gewichtsmessungen (inkl. Körperzusammensetzung, falls vorhanden). Standard: letzte 90 Tage.
Inputs: end_date, start_date.
wellness_activity_summariesC
Wellness-Aktivitätsübersicht pro Tag. Standard: letzte 7 Tage.
Inputs: end_date, start_date.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools target distinct Garmin data domains, and summary-vs-detail pairs like sleep_summaries/sleep_day and hrv_summaries/hrv_day are reasonably clear. However, daily_summaries overlaps heavily with dedicated stress, steps, and body_battery tools, and wellness_activity_summaries is vague, so an agent may hesitate between aggregate and metric-specific tools.
The set is mostly readable snake_case, but conventions are mixed: many tools are noun phrases (profile, daily_summaries, sleep_day), one uses a verb_noun pattern (list_activities), and raw_get is a generic fallback. There is no single predictable naming pattern, though it is not chaotic.
Nineteen tools is slightly above the typical range, but Garmin Connect covers many distinct health and activity data domains, so most tools earn their place. The only mild bloat comes from the overlap between daily_summaries and the metric-specific summary tools.
The surface is broad for read-only health and activity data: profile, daily metrics, sleep, HRV, body battery, stress, steps, weight, SpO2, fitness age, activities, streams, and a raw GET fallback. Minor gaps remain around write operations such as creating workouts, uploading activities, or modifying profile settings beyond GET endpoints.
Maintenance
Related MCP Connectors
Access COROS activity, training and health data, and manage training plans and workouts.
Read wearables and lab health data — sleep, activity, workouts, timeseries, lab tests and orders.
Your own cycling data for your AI assistant: rides, power, climbs and routes. Read-only.
Garmin watch data for AI assistants: activities, sleep, HRV, recovery. Never writes to Garmin.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables read-only access to Garmin Connect data through OAuth, including activities, sleep, HRV, body battery, training status, and scheduled TrainingPeaks workouts.-
- AlicenseCqualityBmaintenanceEnables access to Garmin Connect fitness data through 39 fine-grained tools covering body, heart, sleep, stress, activity, steps, hydration, devices, nutrition, goals, and user profile.403MIT
- AlicenseNot gradedqualityCmaintenanceEnables read-only access to Garmin Connect health and activity data, including daily summaries, sleep, heart rate, stress, Body Battery, HRV, training readiness, activities, and devices.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients such as Claude to query Garmin Connect read-only data including activities, sleep, HRV, Body Battery, training status, and challenges, and to retrieve original FIT files with Connect-IQ sensor channels.MIT