−61%Holiday Watchface Bundle: 12 Garmin-wijzerplaten + 2 feestelijke gratis — € 19,99 in plaats van € 51,38Holiday Bundle: 12 Garmin-wijzerplaten + 2 gratis — € 19,99

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

  1. Garmin Connectje account
  2. Persoonlijke API-sleuteléén keer zichtbaar
  3. Toegangstoken24 uur geldig
  4. Je dataJSON en FIT-bestanden
  5. 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.

DataPer verzoekWat erin zit
ActiviteitenHele geschiedenis, per paginaAfstand, tempo, hartslag en zones, trainingsbelasting en trainingseffect; details en ronden; het originele FIT-bestand
Slaap1 nacht, of 1 maand samenvattingenDiepe, lichte en REM-slaap, wakker, slaapbehoefte
HRVTot 1 jaar samenvattingenNachtgemiddelde, 7-daags gemiddelde, basislijn en status
Body Battery1 maand (31 dagen)Opgeladen, verbruikt en het verloop over de dag
Stress en stappen28 dagenWaarden per dag
DagsamenvattingenTot 1 jaarBody Battery, hartslag, stress, intensieve minuten, ademhaling, pulse ox, calorieën
VO2 maxTot 1 jaarWaarden voor hardlopen en fietsen
Hartslag, SpO21 dagRusthartslag, 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

  1. Open Garmin Connect in een browser op een computer en log in.
  2. Ga in de instellingen naar de pagina voor de persoonlijke API-sleutel (link hieronder).
  3. Kies «Sleutel maken» en lees de extra voorwaarden: de sleutel is alleen voor jou en mag niet aan anderen worden gegeven.
  4. Kies hoe lang de sleutel werkt: 30, 90 of 180 dagen, of 1 jaar. Neem de kortste periode die je nodig hebt.
  5. 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.

Officiële client van Garmin op GitHub →

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.