Garmin API officielle + tableau de bord d'entraînement

Le guide pour créer ta clé API Garmin personnelle et faire construire par Claude Code le tableau de bord de ton entraînement.

Ce que tu obtiens

Garmin donne maintenant à chaque utilisateur une clé API personnelle. C'est la voie officielle : pas de mot de passe à partager, pas de bibliothèque non officielle, et ça atteint tout ton historique. Le mien remonte à juillet 2021 : 1 589 activités, 1 894 jours de pas, fréquence cardiaque au repos, stress et Body Battery, 1 638 nuits de sommeil, et chaque nuit de variabilité cardiaque depuis que la montre l'enregistre.

Ce qu'il te faut

À coller dans Claude Code, pas dans une fenêtre de chat Claude classique : le guide crée des fichiers et lance des commandes sur ton ordinateur, ce qu'un chat normal ne peut pas faire.

Étape 1 : créer ta clé

  1. Va sur connect.garmin.com/app/settings/personalApiToken
  2. Connecte-toi avec ton compte Garmin
  3. Dans Settings, ouvre Personal API Key
  4. Clique sur Create Key
  5. Choisis la durée de validité : 30 jours, 90 jours, 180 jours ou 1 an. Prends 1 an, sinon tu refais la manip en permanence.
  6. Clique sur Create, puis sur Copy. La clé ne s'affiche qu'une seule fois.

Garmin t'envoie un mail environ une semaine avant l'expiration.

La documentation officielle : developer.garmin.com/gc-developer-program/personal/personal-api

Étape 2 : ranger la clé

Dans le dossier de ton projet, crée un fichier .env.local et mets-y ta clé :

GARMIN_API_KEY=ta_cle_ici

C'est ce fichier que Claude Code va lire. Tu ne colles jamais ta clé dans un message.

Étape 3 : le tableau de bord

Ouvre Claude Code dans ce dossier et donne-lui ça :

Lis ma clé Garmin dans .env.local, échange-la contre un access token
via l'endpoint Obtain Token de l'API Garmin Connect, puis récupère tout
mon historique disponible : activités (distance, allure, fréquence
cardiaque, dénivelé), résumés quotidiens (pas, FC de repos, stress,
Body Battery), sommeil et variabilité cardiaque.
Enregistre les données en local, pose-moi quelques questions sur mon
entraînement et sur le style visuel que j'aime, puis construis un
tableau de bord HTML de mon entraînement qui s'ouvre dans mon
navigateur : profondeur de l'historique mois par mois, heures par
sport, totaux (kilomètres, heures, dénivelé cumulé), plus longue
activité, et courbes de récupération dans le temps.

Tu obtiens une page locale avec tes chiffres à toi : les miens affichent 16 540 km, 1 643 heures de sport et l'équivalent de 18 Everest de dénivelé.

Le truc qui manque encore

L'accès en écriture. Tu peux lire tes données, mais pas encore envoyer une séance structurée directement sur ta montre.

Une question ? Réponds-moi en message privé, je lis tout.