garmin-mcp

Sprich mit deinen Garmin-Daten. Ein schreibgeschützter MCP-Server, der es Claude und ChatGPT ermöglicht, Fragen zu deinem Training zu beantworten: Aktivitäten, Schlaf, HRV, Body Battery, Trainingsstatus, Challenge-Ranglisten – und, anders als andere Garmin-MCP-Server, die originale FIT-Datei, die deine Uhr geschrieben hat, einschließlich Connect-IQ-Sensorkanälen (Stryd, Moxy/SmO2, CORE).

You:  How did my last long run compare to the same route in June?
You:  Why is my training readiness so low this morning?
You:  Where do I stand in the running challenge, and who is ahead of me?
You:  Did my Stryd actually record power on Tuesday's session?

Es schreibt nie in Garmin Connect. Jedes Tool ist schreibgeschützt.

Drei Möglichkeiten, es zu nutzen

1. Gastzugang – der einzige Weg, der keinerlei Infrastruktur benötigt: Öffne den Einladungslink, erstelle ein Konto, verbinde dein Garmin, fertig. Wie Weg 3 funktioniert er mit claude.ai im Browser und mit ChatGPT – Weg 2 kann das nicht, weil keiner von beiden ein Programm auf deinem Computer starten kann.

Der Gastzugang ist noch nicht offen. Er läuft derzeit mit einer kleinen Gruppe von Testern, auf persönliche Einladung. Ein öffentlicher Weg, eine Einladung zu beantragen, ist geplant – bis dahin sind Weg 2 und 3 heute nutzbar.

2. Lokal – nichts verlässt deinen Rechner, keine Konten, kein Server. Dein KI-Client startet den Prozess, wenn er ihn braucht. Am besten, wenn du ohnehin Claude Desktop oder Claude Code verwendest und alles lokal behalten möchtest.

3. Eigener Server – dieselbe Software wie hinter dem Gastzugang. Betreibe ihn für dich selbst, lade ein, wen du möchtest, besitze die Daten. Siehe docs/self-hosting.md.

Schnellstart (lokal)

uv tool install git+https://github.com/mskerwiderski/mcp-garmin

garmin-mcp login

Die Anmeldung fragt nach deiner Garmin-E-Mail, deinem Passwort und – falls du es verwendest – deinem Multi-Faktor-Code. Sie speichert nur Garmins OAuth-Tokens in ~/.garmin-mcp/tokens.json mit Modus 0600. Dein Passwort wird nie irgendwo geschrieben.

Dann registriere den Server bei deinem Client:

claude mcp add garmin -- garmin-mcp serve

Starte eine neue Sitzung und stelle eine Frage. Vollständige Anleitung, einschließlich Claude Desktop: docs/install-claude.md.

Dokumentation

Was es beantworten kann

Aktivitäten – Liste und Filter nach Sportart und Datum, Garmins eigene Zusammenfassung einer Aktivität und dieselbe Aktivität, wie das Gerät sie aufgezeichnet hat, direkt aus der FIT-Datei. Zeitreihen für jeden Kanal in der Datei, Pool-Schwimmdetails bis zur einzelnen Bahn, und welche Connect-IQ-Sensoren tatsächlich Daten geliefert haben.

Gesundheit – ein Aufruf pro Tag liefert Schritte, Ruhepuls, Stress, Body Battery, Schlafphasen mit Punktzahl, HRV-Status und Trainingsbereitschaft. Dazu Trainingsstatus mit Belastungsfokus und VO2max, Körperzusammensetzung und Blutdruck über einen Datumsbereich.

Trends und Plan – einen ganzen Monat Schritte, Body Battery und VO2max in einem Aufruf statt einem pro Tag; die geplante Seite von Garmin mit Trainingsplan-Workouts und Rennen, sodass „was geplant war“ und „was passiert ist“ verglichen werden können.

Wo du stehst – Rennvorhersagen für 5 km bis Marathon, Fitnessalter, Ausdauer- und Bergwertung, Lebenszeit-Gesamtwerte und deine persönlichen Rekorde mit der Aktivität, die jeden aufgestellt hat.

Kontext – deine Schwellenwerte und Herzfrequenzzonen, deine Ausrüstung mit den Aktivitäten, Kilometern, Stunden und Tagen dahinter, und die sozialen Challenges, die du gegen Freunde läufst, einschließlich der aktuell laufenden.

Siehe docs/tools.md für die vollständige Liste mit Parametern.

Warum die Anmeldung auf deinem Rechner erfolgt

Garmins SSO sitzt hinter Cloudflare, das seit März 2026 frische Anmeldungen von Rechenzentrums-IPs mit 429 oder 403 beantwortet. Deshalb läuft garmin-mcp login dort, wo du bist. Das resultierende OAuth1-Token ist etwa ein Jahr gültig und erzeugt Zugriffstokens gegen connectapi.garmin.com, sodass nach der Anmeldung nichts mehr sso.garmin.com berührt.

Ein gehosteter Server bietet beides: ein Anmeldeformular (das Passwort wird einmal verwendet und nie gespeichert) und das Einfügen des Token-Blobs aus garmin-mcp export, was der Weg ist, wenn Garmin die Adresse des Servers blockiert.

Gut zu wissen

Dies verwendet Garmins interne Connect-API – dieselbe, die jedes Community-Tool verwendet. Es gibt keine offizielle API für Einzelpersonen; Garmins Health-API ist ein Partnerprogramm. Verwende dies für dein eigenes Konto und beschränke eine gehostete Instanz auf Leute, die du tatsächlich kennst: Alle Konten auf einem Server teilen sich eine Adresse gegenüber Garmin.

Antworten sind bewusst klein. Garmin antwortet mit Hunderten von Feldern pro Aktivität und Zeitreihen mit Tausenden von Punkten; alles wird auf das reduziert, was ein Modell tatsächlich nutzen kann, und Streams werden mit Min/Max/Ø pro Kanal neu abgetastet. Das ist nicht kosmetisch – die rohen Nutzlasten würden das Kontextfenster fressen, das das Gespräch benötigt.

Entwicklung

python3.12 -m venv .venv && .venv/bin/pip install -e ".[dev]"

.venv/bin/pytest

103 Tests, kein Netzwerkzugriff erforderlich – die Garmin-API und die FIT-Dateien sind gestubbt oder synthetisiert. Siehe docs/architecture.md für das Zusammenspiel der Teile.

Lizenz

MIT. Siehe LICENSE.