Garmin Personal API : vos propres données, lues par un assistant IA
Depuis octobre 2026, tout utilisateur de Garmin Connect peut créer une clé API personnelle et récupérer ses activités, son sommeil, sa VFC (variabilité de la fréquence cardiaque, HRV en anglais) et sa Body Battery sous forme de données. Seule, la clé ne sert à rien dans un chat IA : un programme doit l’échanger contre un jeton et aller chercher les données. Voici ce que l’API renvoie vraiment, comment créer la clé et quelle façon de la brancher convient à Claude, ChatGPT ou à un autre assistant.
Comment ça marche
- Garmin Connectvotre compte
- Clé API personnelleaffichée une seule fois
- Jeton d’accèsvalable 24 heures
- Vos donnéesfichiers JSON et FIT
- Assistant IAlecture seule
Vous créez la clé une seule fois sur le site de Garmin Connect. Un programme l’échange contre un jeton d’accès valable 24 heures, puis lit vos données chez Garmin : du JSON pour les données de santé et les résumés d’activités, le fichier FIT d’origine pour chaque activité enregistrée. Rien ne peut être réécrit. L’assistant IA ne voit que ce que le programme a récupéré.
Ce que vous obtenez
Nous avons vérifié chaque jeu de données avec un vrai compte le 18 novembre 2026. La colonne du milieu indique la plus longue période qu’accepte une requête ; pour une période plus longue, récupérez-la en plusieurs fois.
| Données | Par requête | Contenu |
|---|---|---|
| Activités | Tout l’historique, page par page | Distance, allure, fréquence cardiaque et zones, charge d’entraînement et effet d’entraînement ; détails et tours ; le fichier FIT d’origine |
| Sommeil | 1 nuit, ou 1 mois de résumés | Sommeil profond, léger, paradoxal et éveil, besoin de sommeil |
| VFC | Jusqu’à 1 an de résumés | Moyenne de la nuit, moyenne sur 7 jours, valeur de référence et statut |
| Body Battery | 1 mois (31 jours) | Recharge, dépense et valeurs au fil de la journée |
| Stress et pas | 28 jours | Valeurs quotidiennes |
| Résumés quotidiens | Jusqu’à 1 an | Body Battery, fréquence cardiaque, stress, minutes intensives, respiration, oxymètre de pouls, calories |
| VO2 max | Jusqu’à 1 an | Valeurs course à pied et vélo |
| Fréquence cardiaque, SpO2 | 1 jour | Fréquence cardiaque au repos, valeurs de la journée, moyennes SpO2 |
| Aussi | — | Poids, hydratation, zones de fréquence cardiaque, âge physique, cycle menstruel, journal alimentaire, paramètres du profil |
Garmin ne publie pas de limites de requêtes, et ses conditions lui permettent de les changer à tout moment.
Ce qu’elle ne donne pas
Ces données ont répondu « introuvable » lors de notre test, ou ne font pas du tout partie de la clé personnelle :
- La disponibilité d’entraînement et le statut d’entraînement
- Les prédictions de temps de course et les records personnels
- Les entraînements enregistrés, le calendrier d’entraînement, l’équipement et la liste de vos appareils
- Tout ce qui écrit : une IA ne peut envoyer ni entraînement ni parcours sur votre montre. Il faut pour cela les API Training et Courses de Garmin, réservées aux partenaires professionnels agréés.
- Le temps réel : les données n’arrivent qu’après la synchronisation de la montre, et seulement quand votre programme les demande.
✓ La VO2 max est bien disponible, même si certains des premiers guides affirment le contraire.
Étape 1 : créer votre clé
- Ouvrez Garmin Connect dans un navigateur sur ordinateur et connectez-vous.
- Dans les paramètres, allez sur la page de la clé API personnelle (lien ci-dessous).
- Choisissez « Créer une clé » et lisez les conditions supplémentaires : la clé est réservée à vous et ne doit être donnée à personne.
- Choisissez sa durée de validité : 30, 90 ou 180 jours, ou 1 an. Prenez la durée la plus courte qui vous suffit.
- Copiez la clé tout de suite et gardez-la dans un gestionnaire de mots de passe. Garmin ne l’affiche qu’une fois ; si vous la perdez, supprimez-la et créez-en une nouvelle.
Ouvrir la page de la clé API personnelle →
Garmin vous écrit environ une semaine avant l’expiration d’une clé. Supprimer une clé la désactive aussitôt, avec tous les jetons créés à partir d’elle.
Étape 2 : laisser votre assistant IA lire les données
Ni Claude ni ChatGPT ne peuvent utiliser la clé eux-mêmes. Choisissez la méthode qui correspond à votre application.
- Le plus simple et le plus sûr
Un assistant qui exécute des commandes sur votre ordinateur
Claude Code, OpenAI Codex CLI, Cursor et les outils du même genre peuvent lancer le client officiel de Garmin en ligne de commande. Installez-le (Python 3.12 ou plus récent), enregistrez la clé sur une seule ligne dans ~/.config/garmin/connect-personal-api-key, puis demandez à l’assistant d’utiliser gc-personal. La clé reste dans le fichier ; l’assistant lit le JSON affiché par le client.
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 - Serveur local
Claude Desktop et les autres applications compatibles MCP
Claude Desktop lit des données externes via des serveurs MCP qui tournent sur votre ordinateur. Garmin n’en propose pas d’officiel ; plusieurs serveurs open source utilisent la Personal API. Choisissez-en un dont vous pouvez lire le code, gardez-le en lecture seule et placez la clé dans sa configuration locale, pas dans le chat.
- Envoi de fichier
ChatGPT, Gemini et les autres chats en ligne
Un chat dans le navigateur ne peut pas joindre un programme sur votre ordinateur. Exportez les données avec le client officiel et joignez le fichier JSON au chat. Les connecteurs personnalisés de ChatGPT exigent un serveur sur Internet, donc votre clé sur ce serveur.
gc-personal --quiet body-battery \ --start-date 2026-10-18 --end-date 2026-11-17 \ > body-battery.json
✕ Ne collez jamais la clé dans un chat, une capture d’écran ou un document partagé.
✓ Donnez à l’IA les données, pas la clé.
Connecteurs en ligne et conditions de Garmin
Certains services en ligne proposent de relier Garmin à ChatGPT ou à Claude à votre place. Si un service vous demande de coller votre clé API personnelle, vous la confiez à un tiers. Les conditions supplémentaires de Garmin ne l’autorisent pas, et la clé peut être révoquée. Les services qui passent par le programme professionnel de Garmin recueillent votre accord via leur propre accès agréé et n’ont jamais besoin de votre clé personnelle. Vérifiez de quel type il s’agit avant de vous inscrire.
Des questions qui marchent
Demandez la récupération et l’analyse dans un seul message. Quelques idées :
- Récupère mes résumés de sommeil et ma Body Battery des 4 dernières semaines. Quelles nuits ai-je le moins récupéré, et qu’avais-je fait la veille ?
- Liste mes sorties de course de cette année avec la distance, l’allure et la fréquence cardiaque moyenne. À allure égale, mon cœur bat-il moins vite ?
- Compare mon statut VFC des 3 derniers mois avec ma charge d’entraînement hebdomadaire.
- Télécharge le fichier FIT de ma dernière sortie longue et montre l’allure et la fréquence cardiaque à chaque kilomètre.
- Récupère mon stress des 3 derniers mois par tranches de 28 jours et dis-moi quels jours de la semaine sont les plus durs.
Protéger vos données
- La clé ouvre l’accès à vos données de santé. Gardez-la comme un mot de passe et donnez-lui la durée de vie la plus courte possible.
- Rendez les fichiers de clé lisibles par vous seul (chmod 600) et gardez-les hors de git, des dossiers cloud et des sauvegardes partagées.
- Ce que lit l’IA part chez son fournisseur. Vérifiez ses réglages de données, par exemple si les conversations servent à l’entraînement.
- Projet terminé ? Supprimez la clé sur la page de la clé API personnelle.
Questions fréquentes
La Garmin Personal API est-elle gratuite ?
Oui. Tout compte Garmin Connect peut créer une clé personnelle, sans demande ni compte développeur.
Avec quelles montres ça fonctionne ?
L’API lit Garmin Connect, pas la montre : elle couvre donc tout ce que vos montres y ont synchronisé. Les mesures disponibles dépendent du modèle : le statut VFC ou la Body Battery n’apparaissent que si votre montre les enregistre.
ChatGPT ou Claude peuvent-ils modifier quelque chose dans mon compte Garmin ?
Non. La clé personnelle ne fait que lire. Elle ne peut envoyer ni entraînements, ni parcours, ni réglages sur votre montre.
Combien de temps dure un jeton d’accès ?
24 heures, ou jusqu’à l’expiration de la clé si elle arrive avant. Il n’y a pas de jeton d’actualisation : le programme redemande un jeton avec la clé, et le client officiel de Garmin le fait pour vous.
J’ai perdu ma clé. Puis-je la revoir ?
Non. Garmin n’affiche la clé qu’une seule fois. Supprimez-la et créez-en une nouvelle.
Puis-je voir la Body Battery ou la VFC directement sur la montre ?
Oui. Beaucoup de cadrans les affichent au poignet ; filtrez le catalogue par montre pour en trouver un.
Guides associés
Vérifié le 18 novembre 2026 sur la Personal API de Garmin avec un vrai compte. Garmin peut modifier les jeux de données et les limites.
WatchFaceKit n’est affilié ni à Garmin, ni à Anthropic, ni à OpenAI. Garmin et Garmin Connect sont des marques de Garmin Ltd. ou de ses filiales, Claude est une marque d’Anthropic, ChatGPT une marque d’OpenAI.