Garmin Personal API: je eigen data, gelezen door een AI-assistent
Sinds oktober 2026 kan iedereen met een Garmin Connect-account een persoonlijke API-sleutel maken en zijn eigen activiteiten, slaap, HRV en Body Battery als data ophalen. Voor een AI-chat doet de sleutel alleen nog niets: een programma moet hem omruilen voor een token en de data ophalen. Hier lees je wat de API echt teruggeeft, hoe je de sleutel maakt en welke manier past bij Claude, ChatGPT of een andere assistent.
Zo werkt het
- Garmin Connectje account
- Persoonlijke API-sleuteléén keer zichtbaar
- Toegangstoken24 uur geldig
- Je dataJSON en FIT-bestanden
- AI-assistentleest alleen
Je maakt de sleutel één keer op de website van Garmin Connect. Een programma ruilt hem om voor een toegangstoken dat 24 uur werkt en leest daarmee je data bij Garmin: JSON voor gezondheidsdata en samenvattingen van activiteiten, het originele FIT-bestand van elke opgenomen activiteit. Terugschrijven kan niet. De AI-assistent ziet alleen wat het programma heeft opgehaald.
Wat je krijgt
We hebben elke dataset op 18 november 2026 met een echt account gecontroleerd. De middelste kolom is de langste periode die één verzoek accepteert; een langere periode haal je in delen op.
| Data | Per verzoek | Wat erin zit |
|---|---|---|
| Activiteiten | Hele geschiedenis, per pagina | Afstand, tempo, hartslag en zones, trainingsbelasting en trainingseffect; details en ronden; het originele FIT-bestand |
| Slaap | 1 nacht, of 1 maand samenvattingen | Diepe, lichte en REM-slaap, wakker, slaapbehoefte |
| HRV | Tot 1 jaar samenvattingen | Nachtgemiddelde, 7-daags gemiddelde, basislijn en status |
| Body Battery | 1 maand (31 dagen) | Opgeladen, verbruikt en het verloop over de dag |
| Stress en stappen | 28 dagen | Waarden per dag |
| Dagsamenvattingen | Tot 1 jaar | Body Battery, hartslag, stress, intensieve minuten, ademhaling, pulse ox, calorieën |
| VO2 max | Tot 1 jaar | Waarden voor hardlopen en fietsen |
| Hartslag, SpO2 | 1 dag | Rusthartslag, verloop over de dag, SpO2-gemiddelden |
| Verder | — | Gewicht, hydratatie, hartslagzones, fitnessleeftijd, menstruatiecyclus, voedingslogboek, profielinstellingen |
Garmin publiceert geen limieten voor het aantal verzoeken en mag ze volgens de voorwaarden altijd aanpassen.
Wat je er niet mee krijgt
Deze gaven in onze test «niet gevonden» terug, of vallen helemaal buiten de persoonlijke sleutel:
- Trainingsbereidheid en Trainingsstatus
- Racevoorspellingen en persoonlijke records
- Opgeslagen trainingen, de trainingskalender, uitrusting en de lijst met je apparaten
- Alles wat schrijft: een AI kan geen training of koers naar je horloge sturen. Daarvoor zijn de Training- en Courses-API’s van Garmin nodig, en die zijn alleen voor goedgekeurde zakelijke partners.
- Live updates: data is er pas na het synchroniseren van het horloge, en alleen als je programma erom vraagt.
✓ VO2 max zit er wel in, ook al zeggen sommige vroege handleidingen van niet.
Stap 1: maak je sleutel
- Open Garmin Connect in een browser op een computer en log in.
- Ga in de instellingen naar de pagina voor de persoonlijke API-sleutel (link hieronder).
- Kies «Sleutel maken» en lees de extra voorwaarden: de sleutel is alleen voor jou en mag niet aan anderen worden gegeven.
- Kies hoe lang de sleutel werkt: 30, 90 of 180 dagen, of 1 jaar. Neem de kortste periode die je nodig hebt.
- Kopieer de sleutel meteen en bewaar hem in een wachtwoordmanager. Garmin toont hem maar één keer; ben je hem kwijt, verwijder hem dan en maak een nieuwe.
Open de pagina voor de persoonlijke API-sleutel →
Garmin mailt je ongeveer een week voordat een sleutel verloopt. Verwijder je een sleutel, dan werken hij en alle tokens die ermee zijn gemaakt meteen niet meer.
Stap 2: laat je AI-assistent de data lezen
Claude en ChatGPT kunnen de sleutel geen van beide zelf gebruiken. Kies de manier die bij je app past.
- Makkelijkst en veiligst
Een assistent die opdrachten op je computer uitvoert
Claude Code, OpenAI Codex CLI, Cursor en vergelijkbare tools kunnen de officiële command-line-client van Garmin starten. Installeer hem (Python 3.12 of nieuwer), zet de sleutel als één regel in ~/.config/garmin/connect-personal-api-key en vraag de assistent gc-personal te gebruiken. De sleutel blijft in het bestand; de assistent leest de JSON die de client uitvoert.
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 - Lokale server
Claude Desktop en andere apps met MCP
Claude Desktop leest externe data via MCP-servers die op je computer draaien. Garmin heeft er zelf geen; een paar opensource-servers gebruiken de Personal API. Kies er een waarvan je de code kunt lezen, laat hem alleen lezen en zet de sleutel in zijn lokale configuratie, niet in de chat.
- Bestand uploaden
ChatGPT, Gemini en andere webchats
Een webchat kan geen programma op je computer bereiken. Exporteer de data met de officiële client en voeg het JSON-bestand toe aan de chat. Eigen connectors in ChatGPT hebben een server op internet nodig, en dan staat je sleutel op die server.
gc-personal --quiet body-battery \ --start-date 2026-10-18 --end-date 2026-11-17 \ > body-battery.json
✕ Plak de sleutel nooit in een chat, een screenshot of een gedeeld document.
✓ Geef de AI de data, niet de sleutel.
Gehoste connectors en de voorwaarden van Garmin
Sommige webdiensten bieden aan om Garmin voor je aan ChatGPT of Claude te koppelen. Vraagt een dienst om je persoonlijke API-sleutel, dan geef je die aan een derde. De extra voorwaarden van Garmin staan dat niet toe, en de sleutel kan worden ingetrokken. Diensten die via het zakelijke programma van Garmin werken, vragen je toestemming via hun eigen goedgekeurde toegang en hebben je persoonlijke sleutel nooit nodig. Kijk voor je je aanmeldt welk soort dienst het is.
Vragen die werken
Vraag in één bericht om het ophalen én de analyse. Een paar ideeën:
- Haal mijn slaapsamenvattingen en Body Battery van de afgelopen 4 weken op. In welke nachten herstelde ik het slechtst, en wat deed ik de dag ervoor?
- Zet mijn hardlooprondes van dit jaar op een rij met afstand, tempo en gemiddelde hartslag. Daalt mijn hartslag bij hetzelfde tempo?
- Vergelijk mijn HRV-status van de afgelopen 3 maanden met mijn trainingsbelasting per week.
- Download het FIT-bestand van mijn laatste lange duurloop en toon tempo en hartslag per kilometer.
- Haal mijn stress van de afgelopen 3 maanden op in delen van 28 dagen en vertel welke weekdagen het zwaarst zijn.
Je data veilig houden
- De sleutel geeft toegang tot je gezondheidsdata. Bewaar hem als een wachtwoord en geef hem de kortste looptijd die werkt.
- Maak sleutelbestanden alleen voor jezelf leesbaar (chmod 600) en houd ze uit git, cloudmappen en gedeelde back-ups.
- Wat de AI leest, gaat naar de aanbieder van die AI. Controleer de data-instellingen, bijvoorbeeld of chats voor training worden gebruikt.
- Klaar met je project? Verwijder de sleutel op de pagina voor de persoonlijke API-sleutel.
Vragen
Is de Garmin Personal API gratis?
Ja. Elk Garmin Connect-account kan een persoonlijke sleutel maken, zonder aanvraag en zonder ontwikkelaarsaccount.
Met welke horloges werkt het?
De API leest Garmin Connect, niet het horloge, dus alles wat je horloges daar hebben gesynchroniseerd. Welke waarden er zijn, hangt af van het model: HRV-status of Body Battery verschijnen alleen als je horloge ze meet.
Kunnen ChatGPT of Claude iets veranderen in mijn Garmin-account?
Nee. De persoonlijke sleutel kan alleen lezen. Hij kan geen trainingen, koersen of instellingen naar je horloge sturen.
Hoe lang werkt een toegangstoken?
24 uur, of tot de sleutel verloopt als dat eerder is. Er zijn geen refresh tokens: het programma vraagt met de sleutel een nieuw token aan, en de officiële client van Garmin doet dat voor je.
Ik ben mijn sleutel kwijt. Kan ik hem opnieuw zien?
Nee. Garmin toont de sleutel maar één keer. Verwijder hem en maak een nieuwe.
Kan ik Body Battery of HRV op het horloge zelf zien?
Ja. Veel wijzerplaten tonen ze gewoon om je pols; filter de catalogus op je horloge om er een te vinden.
Ook handig
Gecontroleerd op 18 november 2026 met een echt account bij de Personal API van Garmin. Garmin kan de datasets en limieten aanpassen.
WatchFaceKit is niet verbonden aan Garmin, Anthropic of OpenAI. Garmin en Garmin Connect zijn handelsmerken van Garmin Ltd. of haar dochterondernemingen, Claude is een handelsmerk van Anthropic, ChatGPT een handelsmerk van OpenAI.