Piloter sa Garmin depuis Claude Code : le serveur MCP pour un usage personnel
Vous voulez lire vos activités Garmin et écrire des séances sur votre montre depuis le terminal, sans demander un accès à l'API Garmin ni écrire le client OAuth ? Le serveur MCP de Running Workout s'ajoute à Claude Code en une commande. Voici l'installation, les outils exposés et des exemples d'automatisation.
Dernière mise à jour : 2026-09-28
Votre Garmin dans le terminal
Gratuit · connexion officielle Garmin · séances envoyées sur votre montre
Pourquoi passer par un serveur MCP plutôt que par l'API Garmin
L'API Garmin n'est pas ouverte aux particuliers : il faut un compte développeur, une application approuvée par Garmin, et un serveur qui reçoit les données par webhooks. Pour un usage personnel, c'est disproportionné. Running Workout a fait ce travail et l'expose par un serveur MCP : Claude Code, comme Claude, ChatGPT ou Gemini CLI, y accède avec une simple autorisation OAuth sur votre compte.
MCP (Model Context Protocol) est le standard ouvert qui décrit des outils à un assistant : ici, lire vos activités, votre profil, créer des séances, les planifier, gérer un plan. Le serveur est en lecture seule sur vos activités et n'écrit que des entraînements planifiés dans Garmin Connect.
Essayez avec votre propre montre Garmin
Gratuit, sans rien installer : connectez votre Garmin, puis demandez votre première séance à Claude ou ChatGPT. Elle arrive sur la montre en une minute.
Installation en une commande
Créez d'abord votre compte Running Workout en connectant votre Garmin (activez « Données historiques » sur l'écran Garmin). Puis, dans un terminal où Claude Code est installé :
claude mcp add --transport http running-workout https://www.runningworkout.fr/mcpLancez Claude Code, tapez « /mcp », sélectionnez running-workout et authentifiez-vous : le navigateur s'ouvre sur runningworkout.fr, vous validez l'écran d'autorisation, et les outils apparaissent. L'autorisation est un jeton OAuth propre à Claude Code, révocable depuis vos réglages Running Workout.
Pour le partager avec un projet, la même configuration peut vivre dans le fichier .mcp.json du dépôt, avec le transport http et cette adresse ; chaque membre s'authentifie avec son propre compte Garmin.
Les outils exposés
| Outil | Ce qu'il fait |
|---|---|
| get_athlete_profile | VMA, FC max, FTP, charge aiguë et chronique (ACWR), valeurs déclarées, dernières notes |
| list_activities, get_activity_details | Les activités importées, puis le détail d'une sortie : résumé, tours, métriques calculées |
| create_workout | Une séance structurée (course, vélo, natation) envoyée dans Garmin Connect, avec cibles d'allure, de FC, de puissance ou de cadence |
| list_scheduled_workouts, move_scheduled_workout, delete_workout | Le calendrier d'entraînement : lister, déplacer, supprimer |
| set_athlete_data, set_athlete_goal, set_athlete_constraint, add_athlete_note | Mémoire de l'athlète : VMA mesurée, objectif de course, contraintes (jours, blessures), notes |
| start_training_plan, get_plan_week, review_plan_week, schedule_plan_week | Plans 5 km à marathon : démarrer, lire la semaine, la relire après coup, l'envoyer sur la montre |
Chaque outil renvoie du texte lisible par le modèle, avec les unités de votre compte (min/km ou min/mile). Les erreurs sont explicites : une cible impossible pour Garmin est refusée avant l'envoi, avec la marche à suivre.
Exemples d'automatisation
Le bilan du matin
claude -p "Lis ma dernière activité Garmin. Résume-la en 5 lignes : distance, allure moyenne, FC moyenne, dérive cardiaque, et un conseil pour la prochaine séance."La semaine sur la montre
claude -p "Je prépare un 10 km le 15 novembre. Construis ma semaine prochaine (3 séances : fractionné, seuil, sortie longue) à partir de mon profil, puis envoie chaque séance sur ma Garmin à sa date."Un script hebdomadaire
Le mode non interactif de Claude Code (« claude -p ») se lance depuis cron ou un raccourci. Une ligne le dimanche soir suffit pour recevoir le bilan de la semaine et la proposition de la suivante. Gardez la validation humaine pour l'envoi sur la montre : demandez la proposition, relisez, puis envoyez.
Le serveur MCP est le même que celui utilisé par Claude sur le web, ChatGPT et Gemini CLI. Tout ce que vous créez depuis Claude Code apparaît dans votre calendrier Running Workout et dans Garmin Connect.
Limites et bonnes pratiques
- Les activités arrivent par les webhooks Garmin : une sortie apparaît quelques minutes après la synchronisation de la montre.
- Le serveur ne modifie jamais vos activités passées, seulement les entraînements planifiés.
- Une seule cible principale par étape en course à pied ; le vélo accepte une cible secondaire (cadence, FC).
- Le format Garmin impose des bornes : la validation du serveur les applique avant l'envoi et explique les refus.
- Révoquez un jeton depuis vos réglages Running Workout ; chaque client (Claude Code, Claude web, ChatGPT) a le sien.
Questions fréquentes
Faut-il un compte développeur Garmin ?
Non. Running Workout détient l'accès à l'API Garmin et vous le prête, à votre compte, par une autorisation OAuth. Vous n'avez rien à demander à Garmin.
Puis-je appeler le serveur MCP depuis mon propre code, sans Claude ?
Le serveur suit le standard MCP (JSON-RPC sur HTTP avec OAuth 2.1) : tout client MCP conforme peut s'y connecter. Il est conçu pour les assistants, pas comme une API publique documentée ; la page « Écrire une séance sur Garmin par API » décrit le format des séances.
Est-ce que Cursor, Codex ou d'autres agents fonctionnent ?
Tout agent qui accepte un serveur MCP distant avec authentification OAuth peut se connecter à la même adresse. Claude Code, Claude, ChatGPT et Gemini CLI sont ceux que Running Workout teste.
Votre Garmin dans le terminal
Compte gratuit, une commande dans Claude Code, et vos activités sont lisibles, vos séances envoyables.
Commencer