Brancher ta montre Garmin sur Claude Code : le guide complet

Le guide complet pour créer ta clé API Garmin, la brancher sur Claude Code et sortir ton tableau de bord d'entraînement.

Ce que tu vas obtenir

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

Ce qu'il te faut

À coller dans Claude Code, pas dans une fenêtre de chat Claude normale. Ce guide crée des fichiers et lance des commandes sur ton ordinateur, ce qu'un chat classique ne peut pas faire. Claude Code est l'agent de code gratuit qui tourne dans ton terminal et qui fait les étapes à ta place.

Étape 1 : créer ta clé personnelle

  1. Va sur https://connect.garmin.com/app/settings/personalApiToken
  2. Connecte-toi avec ton e-mail et ton mot de passe Garmin
  3. Dans le menu de gauche, clique sur Personal API Key
  4. Clique sur Create Key
  5. À l'écran « Key Expires In », choisis 1 an plutôt que 90 ou 180 jours : tu la renouvelles une seule fois par an au lieu de tous les mois
  6. Garmin affiche la clé une seule fois. Clique sur Copy, puis sur Done

Étape 2 : la ranger pour Claude

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

GARMIN_API_KEY=ta_cle_ici

Ajoute .env.local à ton .gitignore pour qu'elle ne sorte jamais de ton ordinateur.

Étape 3 : le prompt à coller dans Claude Code

Tu vas me construire un tableau de bord de mon entraînement Garmin.

1. Lis ma clé API Garmin dans le fichier .env.local (variable GARMIN_API_KEY). Si le fichier n'existe pas, crée-le, demande-moi ma clé, et ajoute .env.local au .gitignore.
2. Appelle l'API Garmin Connect avec cette clé et récupère tout mon historique : la liste des activités (les 68 champs par activité), les daily summaries (pas, étages, fréquence cardiaque au repos, stress, Body Battery), le sommeil et la HRV. Sauvegarde les données brutes en JSON dans un dossier data/.
3. Pose-moi quelques questions rapides : mes sports principaux, mon objectif en ce moment, et le style visuel que j'aime.
4. Construis un seul fichier HTML autonome qui s'ouvre dans mon navigateur : total d'activités et période couverte, heures par mois par sport, distance totale, chaque course de plus d'un kilomètre en un point avec allure, distance et fréquence cardiaque au survol, pas par jour, fréquence cardiaque au repos, stress, Body Battery et sommeil dans le temps.
5. Ouvre le fichier à la fin et dis-moi ce que mes données disent de mon entraînement.

Ce qui manque encore

L'accès en écriture : pouvoir envoyer une séance construite par l'IA directement sur la montre. Garmin, on attend.

Une question ? Réponds à ce message, j'te réponds.