Garmin Personal API: deine eigenen Daten, ausgewertet von einer KI
Seit Oktober 2026 kann jeder mit einem Garmin-Connect-Konto einen persönlichen API-Schlüssel erstellen und seine Aktivitäten, den Schlaf, die HFV (HRV) und die Body Battery als Daten abrufen. Für einen KI-Chat bringt der Schlüssel allein noch nichts: Ein Programm muss ihn gegen ein Token tauschen und die Daten holen. Hier steht, was die API wirklich liefert, wie du den Schlüssel erstellst und welcher Weg zu Claude, ChatGPT oder einem anderen Assistenten passt.
So funktioniert es
- Garmin Connectdein Konto
- Persönlicher API-Schlüsselnur einmal sichtbar
- Zugriffstoken24 Stunden gültig
- Deine DatenJSON und FIT-Dateien
- KI-Assistentliest nur
Den Schlüssel erstellst du einmal auf der Garmin-Connect-Website. Ein Programm tauscht ihn gegen ein Zugriffstoken, das 24 Stunden gilt, und liest damit deine Daten bei Garmin: JSON für Gesundheitswerte und Aktivitätsübersichten, die originale FIT-Datei für jede aufgezeichnete Aktivität. Zurückschreiben lässt sich nichts. Der KI-Assistent sieht nur, was das Programm abgerufen hat.
Was du bekommst
Wir haben jeden Datensatz am 18. November 2026 mit einem echten Konto geprüft. Die mittlere Spalte ist der längste Zeitraum, den eine Anfrage annimmt; längere Zeiträume holst du in Teilen.
| Daten | Pro Anfrage | Was drinsteckt |
|---|---|---|
| Aktivitäten | Gesamter Verlauf, seitenweise | Distanz, Pace, Herzfrequenz und Bereiche, Trainingsbelastung und Trainingseffekt; Details und Runden; die originale FIT-Datei |
| Schlaf | 1 Nacht oder 1 Monat Übersichten | Tiefschlaf, leichter Schlaf, REM, Wachzeit, Schlafbedarf |
| HFV | Bis zu 1 Jahr Übersichten | Nachtdurchschnitt, 7-Tage-Durchschnitt, Ausgangswert und Status |
| Body Battery | 1 Monat (31 Tage) | Aufgeladen, verbraucht und Werte über den Tag |
| Stress und Schritte | 28 Tage | Tageswerte |
| Tagesübersichten | Bis zu 1 Jahr | Body Battery, Herzfrequenz, Stress, Intensitätsminuten, Atmung, Pulsoximeter, Kalorien |
| VO2max | Bis zu 1 Jahr | Werte für Laufen und Radfahren |
| Herzfrequenz, SpO2 | 1 Tag | Ruhepuls, Werte über den Tag, SpO2-Mittelwerte |
| Außerdem | — | Gewicht, Flüssigkeitszufuhr, Herzfrequenzbereiche, Fitnessalter, Menstruationszyklus, Ernährungstagebuch, Profileinstellungen |
Garmin veröffentlicht keine Anfragelimits und darf sie laut Bedingungen jederzeit ändern.
Was sie nicht liefert
Diese Daten kamen im Test als «nicht gefunden» zurück oder gehören gar nicht zum persönlichen Schlüssel:
- Trainingsbereitschaft und Trainingsstatus
- Wettkampfprognosen und persönliche Rekorde
- Gespeicherte Workouts, der Trainingskalender, Ausrüstung und die Liste deiner Geräte
- Alles, was schreibt: Eine KI kann kein Workout und keinen Kurs auf deine Uhr schicken. Dafür braucht es die Training- und Courses-APIs von Garmin, die nur freigegebene Geschäftspartner bekommen.
- Live-Daten: Daten gibt es erst nach der Synchronisierung der Uhr und nur dann, wenn dein Programm sie anfragt.
✓ VO2max ist dabei, auch wenn manche frühen Anleitungen das Gegenteil behaupten.
Schritt 1: Schlüssel erstellen
- Öffne Garmin Connect im Browser am Computer und melde dich an.
- Geh in den Einstellungen auf die Seite für den persönlichen API-Schlüssel (Link unten).
- Wähle «Schlüssel erstellen» und lies die Zusatzbedingungen: Der Schlüssel ist nur für dich und darf nicht an andere weitergegeben werden.
- Lege fest, wie lange er gilt: 30, 90 oder 180 Tage oder 1 Jahr. Nimm den kürzesten Zeitraum, der reicht.
- Kopiere den Schlüssel sofort und bewahre ihn in einem Passwortmanager auf. Garmin zeigt ihn nur einmal; ist er weg, löschst du ihn und erstellst einen neuen.
Seite für den persönlichen API-Schlüssel öffnen →
Garmin schickt etwa eine Woche vor Ablauf eine E-Mail. Löschst du einen Schlüssel, funktionieren er und alle damit erzeugten Tokens sofort nicht mehr.
Schritt 2: die KI an die Daten lassen
Weder Claude noch ChatGPT können den Schlüssel selbst verwenden. Nimm den Weg, der zu deiner App passt.
- Am einfachsten und sichersten
Ein Assistent, der Befehle auf deinem Computer ausführt
Claude Code, OpenAI Codex CLI, Cursor und ähnliche Tools können den offiziellen Kommandozeilen-Client von Garmin starten. Installiere ihn (Python 3.12 oder neuer), speichere den Schlüssel als eine Zeile in ~/.config/garmin/connect-personal-api-key und bitte den Assistenten, gc-personal zu verwenden. Der Schlüssel bleibt in der Datei, der Assistent liest das JSON, das der Client ausgibt.
python3 -m pip install garmin-connect-personal-api-python chmod 600 ~/.config/garmin/connect-personal-api-key gc-personal sleep-summaries \ --start-date 2026-10-21 --end-date 2026-11-17 - Lokaler Server
Claude Desktop und andere Apps mit MCP
Claude Desktop liest fremde Daten über MCP-Server, die auf deinem Computer laufen. Einen offiziellen gibt es von Garmin nicht; mehrere Open-Source-Server nutzen die Personal API. Nimm einen, dessen Code du lesen kannst, lass ihn nur lesen und trag den Schlüssel in seine lokale Konfiguration ein, nicht in den Chat.
- Datei hochladen
ChatGPT, Gemini und andere Web-Chats
Ein Web-Chat erreicht kein Programm auf deinem Computer. Exportiere die Daten mit dem offiziellen Client und häng die JSON-Datei an den Chat. Eigene Connectors in ChatGPT brauchen einen Server im Internet, und dann liegt dein Schlüssel auf diesem Server.
gc-personal --quiet body-battery \ --start-date 2026-10-18 --end-date 2026-11-17 \ > body-battery.json
✕ Den Schlüssel nie in einen Chat, einen Screenshot oder ein geteiltes Dokument einfügen.
✓ Gib der KI die Daten, nicht den Schlüssel.
Gehostete Connectors und die Bedingungen von Garmin
Manche Webdienste bieten an, Garmin für dich mit ChatGPT oder Claude zu verbinden. Verlangt ein Dienst deinen persönlichen API-Schlüssel, gibst du ihn an Dritte weiter. Das erlauben die Zusatzbedingungen von Garmin nicht, und der Schlüssel kann gesperrt werden. Dienste, die über das Business-Programm von Garmin arbeiten, holen deine Zustimmung über ihren eigenen freigegebenen Zugang ein und brauchen deinen persönlichen Schlüssel nie. Prüf vor der Anmeldung, welche Art du vor dir hast.
Fragen, die funktionieren
Bitte in einer Nachricht um Abruf und Auswertung. Ein paar Ideen:
- Hol meine Schlafübersichten und die Body Battery der letzten 4 Wochen. In welchen Nächten habe ich mich am schlechtesten erholt, und was war am Tag davor?
- Liste meine Läufe in diesem Jahr mit Distanz, Pace und Durchschnittspuls. Sinkt mein Puls bei gleicher Pace?
- Vergleiche meinen HFV-Status der letzten 3 Monate mit meiner wöchentlichen Trainingsbelastung.
- Lade die FIT-Datei meines letzten langen Laufs und zeig Pace und Puls pro Kilometer.
- Hol meinen Stress der letzten 3 Monate in 28-Tage-Teilen und sag mir, welche Wochentage am härtesten sind.
Deine Daten schützen
- Der Schlüssel öffnet deine Gesundheitsdaten. Bewahre ihn wie ein Passwort auf und gib ihm die kürzeste Laufzeit, die reicht.
- Schlüsseldateien nur für dich lesbar machen (chmod 600) und aus Git, Cloud-Ordnern und geteilten Backups heraushalten.
- Was die KI liest, geht an ihren Anbieter. Prüf die Datenschutzeinstellungen, zum Beispiel ob Chats zum Training genutzt werden.
- Projekt erledigt? Lösch den Schlüssel auf der Seite für den persönlichen API-Schlüssel.
Fragen
Ist die Garmin Personal API kostenlos?
Ja. Jedes Garmin-Connect-Konto kann einen persönlichen Schlüssel erstellen, ohne Antrag und ohne Entwicklerkonto.
Mit welchen Uhren funktioniert das?
Die API liest Garmin Connect, nicht die Uhr. Sie umfasst also alles, was deine Uhren dorthin synchronisiert haben. Welche Werte es gibt, hängt vom Modell ab: HFV-Status oder Body Battery erscheinen nur, wenn deine Uhr sie misst.
Können ChatGPT oder Claude etwas in meinem Garmin-Konto ändern?
Nein. Der persönliche Schlüssel kann nur lesen. Er schickt keine Workouts, Kurse oder Einstellungen an die Uhr.
Wie lange gilt ein Zugriffstoken?
24 Stunden oder bis zum Ablauf des Schlüssels, je nachdem, was früher kommt. Refresh-Tokens gibt es nicht: Das Programm holt mit dem Schlüssel ein neues Token, der offizielle Client von Garmin erledigt das selbst.
Ich habe meinen Schlüssel verloren. Kann ich ihn noch einmal sehen?
Nein. Garmin zeigt den Schlüssel nur einmal. Lösch ihn und erstelle einen neuen.
Kann ich Body Battery oder HFV direkt auf der Uhr sehen?
Ja. Viele Zifferblätter zeigen sie direkt am Handgelenk; filtere den Katalog nach deiner Uhr.
Passend dazu
Geprüft am 18. November 2026 mit einem echten Konto an der Personal API von Garmin. Garmin kann Datensätze und Limits ändern.
WatchFaceKit steht in keiner Verbindung zu Garmin, Anthropic oder OpenAI. Garmin und Garmin Connect sind Marken von Garmin Ltd. oder ihren Tochtergesellschaften, Claude ist eine Marke von Anthropic, ChatGPT eine Marke von OpenAI.