Connecter Garmin à Gemini
Gemini atteint garmlink via le Model Context Protocol (MCP) de trois façons : comme appli personnalisée dans l’application Gemini sur le web, par Gemini CLI pour un usage individuel, ou par Gemini Enterprise pour une organisation. Ce guide couvre les trois.
Connecte ton compte Garmin
Sur l’écran Connecter ta Garmin, connecte-toi à Garmin Connect avec ton email et ton mot de passe (utilisé une seule fois, jamais stocké), saisis le code de vérification si Garmin le demande, et attends que le statut passe à Connecté. garmlink commence aussitôt à synchroniser tes activités, ton sommeil, ta VFC et tes métriques d’entraînement.
Chemin A — application Gemini (web)
Google ouvre les applis personnalisées progressivement : pour l’instant, elles apparaissent sur les comptes Google personnels aux États-Unis, à partir de 18 ans, avec Gemini en anglais et l’activité conservée (Keep Activity). Tu ne les vois pas encore ? Le chemin B marche partout.
- 2.
Ajoute garmlink comme appli personnalisée
Sur gemini.google.com, ouvre Settings, puis Connected Apps, et Custom apps. Colle l’adresse garmlink et clique sur Next :https://api.garmlink.ai/mcpGemini ouvre la page de connexion garmlink : connecte-toi, puis appuie sur Autoriser.
- 3.
Appelle garmlink dans une conversation
Dans une conversation, tape @ et choisis garmlink, puis demande :- « Comment ai-je dormi cette semaine ? »
- « Résume mes cinq dernières courses. »
- « Ma charge d’entraînement monte ou descend ce mois-ci ? »
Chemin B — Gemini CLI (particulier)
- 4.
Installe Gemini CLI
Installe la CLI en global, puis lance-la une fois pour qu’elle crée son dossier de configuration :npm install -g @google/gemini-cligemini
Connecte-toi avec ton compte Google quand elle le demande.
- 5.
Déclare garmlink dans les réglages de la CLI
Ouvre~/.gemini/settings.json(crée-le s’il n’existe pas) et déclare garmlink comme serveur MCP :{ "mcpServers": { "garmlink": { "httpUrl": "https://api.garmlink.ai/mcp", "oauth": { "enabled": true } } } }Rien d’autre ne va dans ce fichier — ni en-tête, ni clé d’API, ni secret client. Avec OAuth activé, Gemini CLI mène tout le flux OAuth 2.0 lui-même.
- 6.
Lance la CLI et autorise l’accès
Lancegeminidans un terminal. Au premier appel à garmlink, une fenêtre de navigateur s’ouvre : connecte-toi, autorise l’accès en lecture seule, et la CLI garde les jetons en local pour la suite.Ensuite, pose tes questions en langage courant :
- « Comment ai-je dormi cette semaine ? »
- « Résume mes cinq dernières courses. »
- « Ma charge d’entraînement monte ou descend ce mois-ci ? »
Chemin C — Gemini Enterprise (organisation)
- 7.
Ajoute le serveur MCP dans Gemini Enterprise
Dans Gemini Enterprise, ouvre Connected apps → Add MCP Server. Renseigne les infos du serveur MCP — un nom, une description et l’URL garmlink :https://api.garmlink.ai/mcpSeul le transport StreamableHTTP est accepté — les anciens serveurs MCP en SSE sont refusés. garmlink est en StreamableHTTP, il est donc compatible.
Icône (facultatif)
PNG, 256×256, ≤ 10 Ko. L’icône garmlink porte son propre fond : elle reste lisible que l’interface de l’assistant soit claire ou sombre.
- 8.
Authentifie-toi et choisis la portée
Choisis OAuth comme méthode d’authentification et termine la connexion garmlink. Définis ensuite la portée : publier la connexion pour toute l’organisation, ou demander à chaque membre de s’authentifier avec son propre compte garmlink.
- Pas d’option Custom apps dans l’application Gemini. Ton compte n’a pas encore les applis personnalisées — Google les ouvre d’abord aux comptes personnels aux États-Unis, en anglais. En attendant, passe par Gemini CLI, ou par Gemini Enterprise si ton organisation en dispose.
- La connexion s’arrête après Autoriser. Ajoute à nouveau garmlink dans Custom apps : la deuxième tentative passe en général.
- La CLI n’arrive pas à s’authentifier. Vérifie que
~/.gemini/settings.jsonne contient ni en-tête ni jeton à côté du bloc OAuth — un en-tête Authorization périmé prend le pas sur le flux OAuth et le serveur répond 401. - Le serveur est injoignable. L’URL MCP doit être joignable en HTTPS depuis la machine qui exécute la CLI (ou depuis Gemini Enterprise) — vérifie qu’aucun proxy ni pare-feu ne la bloque.
- Les données semblent vides ou anciennes. Regarde où en est la synchro sur l’écran Connecter ta Garmin.
Tu utilises un autre assistant ? Va voir tous les guides de configuration. Envie de savoir ce que garmlink peut lire ? Parcours la référence des outils. Envie de voir de vraies réponses ? Lis les douze exemples tirés d’un vrai compte.
