Skills

gccli: guía para consultar datos de Garmin Connect por línea de comandos y con un agente

gccli es ideal para consultar directamente tus actividades, salud y composición corporal de Garmin Connect desde la terminal o un cliente agente, y pasar a los scripts una salida JSON o plain/TSV procesable. Antes de usarlo debes completar la autenticación por Garmin SSO, y el archivo de tokens de respaldo se cifra con una frase de contraseña fija incrustada en el código fuente: comprueba que te parece aceptable antes de empezar.

Official source · gccli — A command-line interface for Garmin Connect

Install

brew install bpauli/tap/gccli

Para quién es

gccli es una herramienta de línea de comandos para Garmin Connect, posicionada oficialmente como una «CLI rápida y apta para scripts», con acceso a actividades, datos de salud, composición corporal, entrenamientos, recorridos, dispositivos, equipo, objetivos y medallas. Encaja con:

  • Quienes quieran consultar sus datos de Garmin directamente en la terminal y llevar los resultados a scripts: el proyecto oficial ofrece dos modos de salida procesables, JSON y plain/TSV, orientados explícitamente a scripts y automatización.
  • Quienes trabajan dentro de un cliente agente y quieren delegar en el agente la consulta de datos: gccli incluye un agent skill listo para usar que, según la descripción oficial, está dirigido a clientes de agentes de IA como Claude Code, Codex, Hermes y OpenClaw.
  • Desarrolladores que necesiten integrar entrenamientos y datos de salud en flujos automatizados.

Casos en los que no encaja, o que conviene confirmar antes:

  • Sin cuenta de Garmin Connect no se puede usar: la autenticación se realiza mediante Garmin SSO; es un requisito indispensable.
  • Entornos donde no quieras Homebrew: el único comando de instalación copiable que da la documentación oficial es Homebrew; compilar desde el código fuente exige Go 1.26 o superior, y los pasos completos de compilación no aparecen en el repositorio oficial.
  • La lista de clientes es un ejemplo oficial, no exhaustiva; no se indica si hay compatibilidad fuera de ella, así que consulta la documentación del repositorio antes de integrar.

Primer intento en 3 minutos

El camino principal recomendado es uno solo: instalar con Homebrew, completar la autenticación por Garmin SSO y pedir al agente que ejecute una consulta.

Requisitos previos: ya tienes cuenta de Garmin Connect; Homebrew está instalado en tu equipo; y sabes que la primera autenticación escribe las credenciales en el keyring del sistema (efectos secundarios en «Límites de uso»).

Paso 1, instalar:

brew install bpauli/tap/gccli

Paso 2, autenticarte. La autenticación se realiza vía Garmin SSO y las credenciales se guardan en el keyring del sistema. Un detalle que debes saber antes: la documentación oficial afirma claramente que gccli cifra cada archivo de tokens con una frase de contraseña fija incrustada en el código fuente; es decir, el archivo de tokens de respaldo que se usa cuando el keyring no está disponible, y esa frase no es un secreto exclusivo tuyo. Decide tú, antes de la primera autenticación, si aceptas esa forma de almacenamiento. La documentación oficial no da un comando de inicio de sesión concreto; tras instalar, guíate por la ayuda integrada de gccli.

Paso 3, conectar el agente con la skill. El agent skill incluido con gccli está en skills/gccli/SKILL.md y, según el proyecto oficial, está listo para usar; los pasos para conectarlo a tu cliente concreto no los da la documentación oficial: guíate por la documentación de cada cliente.

Paso 4, lanzar una tarea de consulta. Dile directamente al agente: «Muéstrame mis últimas actividades de carrera y los datos de composición corporal de esta semana». Este tipo de tarea cae dentro de las capacidades de acceso a datos que lista la documentación oficial; si el proceso de consulta escribe archivos locales no está explicado oficialmente y queda sin confirmar. El único efecto de escritura confirmado es el almacenamiento de tokens (ver «Límites de uso»): no des por hecho que sea de solo lectura.

Paso 5, comprobar la señal de éxito: la respuesta debe ser una salida procesable en modo JSON o plain/TSV, lista para pegar o entregar a un script; al ver salida estructurada, la cadena funciona.

Casos de uso

Caso 1: resumir entrenamientos y datos corporales.

  • Escenario: ver de una vez los últimos entrenamientos y la evolución del peso, sin repasar registro por registro la web.
  • Lanzamiento: en un cliente agente conectado a gccli, di «Lista mis últimos entrenamientos y registros de composición corporal».
  • Flujo: el agente accede vía gccli a actividades y composición corporal, dos categorías de datos confirmadas oficialmente.
  • Resultado esperable: una salida JSON o plain/TSV procesable, para pegar en una hoja de cálculo o entregar a un script; la lista de campos por registro no está documentada oficialmente: manda la respuesta real.

Caso 2: integrar los datos de Garmin en scripts de automatización.

  • Escenario: resumir cada semana dispositivos, equipo, objetivos y medallas para construir tu propio archivo de entrenamiento.
  • Lanzamiento: llama a gccli desde tus scripts existentes o tareas de agente programadas y pasa la salida al siguiente paso.
  • Flujo: apóyate en el enfoque oficial «apto para scripts» y en los modos de salida JSON y plain/TSV para conectar con tus flujos actuales.
  • Resultado esperable: una salida legible por máquina que entra de forma estable en el siguiente paso; la lista exacta de subcomandos y parámetros no se da literalmente en la documentación oficial: revisa la ayuda de gccli y el repositorio antes de empezar.

Límites de uso

  • Red y cuenta: los datos vienen de la nube de Garmin Connect; la autenticación y cada consulta necesitan conexión a Internet y tu cuenta de Garmin. No se menciona capacidad sin conexión y no está confirmada.
  • Credenciales y efectos de escritura: la primera autenticación va por Garmin SSO y escribe las credenciales en el keyring del sistema; el archivo de tokens de respaldo, usado cuando el keyring no está disponible, se cifra con una frase de contraseña fija incrustada en el código fuente. Aparte del almacenamiento de tokens, no se explica oficialmente si las consultas escriben otros archivos, y queda sin confirmar.
  • Entorno de ejecución: compilar desde el código fuente exige Go 1.26 o superior; el camino principal recomendado instala vía Homebrew, sin compilación local. El resto de requisitos de ejecución no se documentan.
  • Requisito de cliente: el agent skill incluido está dirigido a clientes de agentes de IA como Claude Code, Codex, Hermes y OpenClaw; no se detalla oficialmente si hay compatibilidad fuera de esa lista ni si los pasos de integración coinciden entre clientes: consulta la documentación de cada cliente antes de integrar.
  • Límites explícitos: no se mencionan oficialmente límites de frecuencia, topes de exportación ni restricciones de los términos de servicio; consulta el repositorio oficial antes de un uso masivo o de alta frecuencia.