Garmin ya deja que cualquier usuario saque sus propios datos con una llave personal, gratis y sin pedir permiso. Y eso significa que puedes conectar tu reloj a Claude y preguntarle en español por tus entrenos, tu sueño o tu recuperación. Te cuento qué es, para qué sirve de verdad a un triatleta y cómo dejarlo funcionando en unos 15 minutos. Vamos al lío.
Qué es la Personal API de Garmin
Es una llave (una «key») que generas tú mismo en Garmin Connect y que da acceso de solo lectura a los datos de tu cuenta. Hasta ahora, para leer tus datos de Garmin desde otra app había que ser empresa y pasar una solicitud. Ahora no hay solicitud ni aprobación: entras, la creas y listo (the5krunner).
Qué te da:
- Actividades: resúmenes y archivos .FIT con GPS, pulso, cadencia, potencia y vueltas.
- Salud: sueño, HRV, Body Battery, estrés, pasos y salud femenina.
- Gratis: el nivel personal no cuesta nada.
Qué no te da:
- No escribe nada. No sube entrenamientos al reloj ni cambia nada en tu cuenta.
- No trae todo lo calculado. Según the5krunner, algunos valores como el VO2 máx o el tiempo de recuperación no vienen en los archivos que da la API.
Para qué sirve: pregúntale como a tu entrenador
La gracia es que no tienes que bucear en gráficas: le preguntas en español y Claude va a buscar los datos de tu reloj. Algunas preguntas que tienen sentido si entrenas triatlón:
- «¿Cómo dormí la semana antes de mi último triatlón y cómo estaba mi HRV?»
- «¿En qué kilómetro de la carrera a pie del domingo se me cayó el ritmo y qué hizo el pulso?»
- «Compara mi volumen de natación, bici y carrera de los últimos 3 meses.»
- «¿Estoy recuperado para meter series fuertes hoy?»
- «¿Qué tal fue mi potencia media en las salidas largas de bici de este mes?»
Ojo: Claude interpreta datos, no es tu médico ni tu entrenador. Úsalo para entender mejor lo que ya mide tu reloj.
Qué necesitas antes de empezar
| Qué | Para qué | Precio |
|---|---|---|
| Cuenta de Garmin Connect | Crear tu key | Gratis |
| Un ordenador (Mac o Windows) | Aquí corre la conexión | — |
| Claude Desktop | La app desde la que preguntas | Gratis para empezar |
| Node.js 20 o superior | Lo que hace funcionar el conector | Gratis |
No hace falta saber programar: solo copiar y pegar un bloque de texto.
Paso a paso
Paso 1. Crea tu key en Garmin Connect
- Entra en connect.garmin.com desde el ordenador (desde la app del móvil no sale).
- Ve a Configuración → Personal API.
- Pulsa Create, acepta los términos y elige cuánto dura: de 30 días a un año. Yo pondría un año, así solo lo repites una vez.
- Copia la key y guárdala en un sitio seguro. Garmin solo te la enseña una vez.
Paso 2. Instala Claude Desktop y Node.js
- Descarga Claude Desktop en claude.ai/download e inicia sesión.
- Descarga Node.js en nodejs.org, la versión LTS, e instálalo como cualquier programa.
Paso 3. Pega tu key en la configuración
En Claude Desktop ve a Configuración → Desarrollador → Editar configuración. Se abre un archivo de texto; pega esto:
{
"mcpServers": {
"garmin": {
"command": "npx",
"args": ["-y", "garmin-personal-mcp"],
"env": {
"GARMIN_PERSONAL_API_KEY": "TU-KEY"
}
}
}
}Cambia TU-KEY por tu key, sin quitar las comillas, y guarda el archivo. Si ya tenías otros conectores en ese archivo, añade solo el bloque «garmin» dentro de «mcpServers».
Paso 4. Reinicia Claude y pregunta
- Cierra Claude del todo, no solo la ventana. En Mac, Cmd+Q. En Windows, clic derecho en el icono de Claude junto a la hora → Salir.
- Ábrelo y empieza un chat nuevo. El conector solo se carga en chats nuevos.
- Pruébalo con algo como: «¿Qué dice mi Garmin de esta semana?»
Si te responde con tus datos, ya está. Si no tienes datos de sueño o HRV, duerme con el reloj puesto y sincroniza la app.
Lo que tienes que saber
- El conector no es de Garmin ni de Anthropic. garmin-personal-mcp es un proyecto de código abierto de la comunidad. La API sí es oficial.
- Caduca. Cuando venza, crea otra key y cámbiala en el paso 3.
- Solo funciona en ese ordenador. Para usarlo desde el móvil o desde ChatGPT haría falta montarlo en un servidor propio.
- Hay límites por consulta. Por ejemplo, el sueño y el Body Battery se piden de 28 en 28 días y el estrés y los pasos de 7 en 7 (ShapeCalendar). Claude lo reparte solo, pero las preguntas de muchos meses van más lentas.
- El histórico no está claro. Hay quien dice que solo llegan las actividades nuevas y quien dice que también las antiguas. Pruébalo con tu cuenta antes de fiarte de un análisis de años.
Tu key es como una contraseña. No la compartas, no la pegues en un chat ni la enseñes en un vídeo. Si se te escapa, bórrala en Garmin Connect y el acceso se corta.
Mi opinión: ¿merece la pena?
Para mí es el cambio más interesante de Garmin en años, porque los datos que genera tu reloj por fin son tuyos de verdad: puedes preguntarle a la IA por tus entrenos, tu sueño o tu recuperación sin pelearte con gráficas.
Lo que menos me convence es que haya que tocar un archivo de configuración y que, de momento, solo funcione en el ordenador. Pero si no te asusta copiar y pegar, en 15 minutos lo tienes.
Y tú, ¿qué le preguntarías a tu Garmin? Déjamelo en comentarios y lo pruebo en el próximo vídeo.
