Cómo conectar Garmin con Claude (MCP)

Lo importante, en 30 segundos:

• Vas a conectar tu cuenta de Garmin Connect con Claude Desktop para que la IA lea tus datos directamente: sueño, VFC, carga de entrenamiento, actividades, potencia.
• Se hace una sola vez y tarda unos 15 minutos. No hay que saber programar, pero sí copiar y pegar con cuidado.
• Necesitas: un ordenador (Mac o Windows), Claude Desktop y Node.js instalado.
• ⚠️ Tu contraseña de Garmin queda guardada en texto plano en un archivo de tu ordenador. Lee el aviso de seguridad antes de empezar.
• Una vez conectado, cada mañana puedes preguntarle «¿qué tal he dormido?» y responde con tus datos reales.

En el vídeo os conté que llevo semanas dejando que una inteligencia artificial analice mis datos de Garmin y me diga cómo entrenar cada día. Muchos me habéis preguntado cómo se monta eso exactamente, así que aquí lo tenéis paso a paso.

Voy a intentar explicarlo como me habría gustado que me lo explicaran a mí: sin dar por hecho que sabes lo que es una terminal ni un archivo JSON.

Antes de nada: lee esto

Hay tres cosas que tienes que saber antes de empezar, y prefiero decírtelas yo a que las descubras a mitad de camino.

1. Tu contraseña de Garmin se guarda en texto plano

El método que te voy a explicar guarda tu correo y tu contraseña de Garmin dentro de un archivo de configuración de tu ordenador, sin cifrar. Cualquiera que abra ese archivo puede leerla.

Qué hacer al respecto:

• Usa una contraseña única para Garmin, que no repitas en ningún otro servicio. Si algún día ese archivo acabara donde no debe, el daño se queda ahí.
• No hagas esto en un ordenador compartido ni en uno del trabajo.
• Cuidado si grabas la pantalla o compartes escritorio: no abras ese archivo delante de la cámara. (A mí casi me pasa.)

2. Es una herramienta de la comunidad, no oficial

El conector que vamos a usar no lo ha hecho ni Garmin ni Anthropic: es un proyecto de código abierto creado por la comunidad. Funciona muy bien, pero conviene que lo sepas: no tiene soporte oficial de nadie y accede a tus datos por una vía no oficial.

3. Esto no es un entrenador ni un médico

Lo que consigues es una herramienta que entiende tus datos y te ayuda a tomar decisiones más informadas. No sustituye a un entrenador de carne y hueso y desde luego no sustituye a un médico. Si tienes cualquier problema de salud, consulta antes con un profesional.

Qué necesitas

• Un ordenador, Mac o Windows. Esto no se puede hacer desde el móvil.
• Claude Desktop, la aplicación de escritorio de Claude. La versión web no vale para esto.
• Node.js instalado en el ordenador (te explico cómo en el paso 1).
• Tu cuenta de Garmin Connect: el correo y la contraseña.

Paso 1 · Instalar Node.js

Node.js es un programa que hace de motor para que funcione el conector. No tienes que aprender nada de él, solo instalarlo.

1. Entra en nodejs.org
2. Descarga la versión LTS (es la estable, la que recomiendan por defecto). Asegúrate de que sea la versión 20 o superior.
3. Ábrelo y dale a siguiente hasta el final, como cualquier programa.

Ya está. No hay que configurar nada.

Paso 2 · Abrir el archivo de configuración de Claude

Aquí es donde le vamos a decir a Claude que existe Garmin. Hay una forma fácil y una forma manual.

La forma fácil

1. Abre Claude Desktop.
2. Ve a Ajustes (Settings).
3. Busca la sección de Desarrollador (Developer).
4. Ahí encontrarás un botón para editar la configuración. Al pulsarlo se abre directamente el archivo que necesitamos.

La forma manual (si no encuentras ese botón)

El archivo se llama claude_desktop_config.json y está aquí:

• En Mac: ~/Library/Application Support/Claude/
  Para llegar: abre Finder, menú Ir → Ir a la carpeta…, pega esa ruta y pulsa Enter.
• En Windows: %APPDATA%\Claude\
  Para llegar: pulsa Windows + R, escribe %APPDATA%\Claude y pulsa Enter.

Si el archivo no existe, créalo tú con ese nombre exacto. Ábrelo con un editor de texto sencillo (TextEdit en Mac, Bloc de notas en Windows).

Paso 3 · Pegar la configuración

Este es el único momento delicado. Copia esto tal cual y pégalo en el archivo:

{
  "mcpServers": {
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "tucorreo@ejemplo.com",
        "GARMIN_PASSWORD": "tucontraseña"
      }
    }
  }
}

Ahora sustituye dos cosas:

• tucorreo@ejemplo.com → el correo de tu cuenta de Garmin
• tucontraseña → tu contraseña de Garmin

Muy importante: deja las comillas donde están. Solo cambias lo que hay dentro de ellas. Si borras una comilla o una coma, el archivo deja de funcionar y Claude no te dirá por qué.

Guarda el archivo y ciérralo.

¿Y si ya tenías otras cosas configuradas ahí?

Si al abrir el archivo ya había contenido con otros conectores, no lo borres. Añade la parte de "garmin" dentro del bloque "mcpServers" que ya existe, separándola con una coma del anterior. Así:

{
  "mcpServers": {
    "otro-conector-que-ya-tenías": {
      ...
    },
    "garmin": {
      "command": "npx",
      "args": ["-y", "@nicolasvegam/garmin-connect-mcp"],
      "env": {
        "GARMIN_EMAIL": "tucorreo@ejemplo.com",
        "GARMIN_PASSWORD": "tucontraseña"
      }
    }
  }
}

Paso 4 · Reiniciar Claude Desktop de verdad

Y ojo con esto, que es donde más gente se atasca: no basta con cerrar la ventana. Hay que cerrar la aplicación por completo y volver a abrirla.

• En Mac: clic derecho en el icono de Claude en el Dock → Salir. O Cmd + Q con la app en primer plano.
• En Windows: ciérrala y comprueba que tampoco esté corriendo en la bandeja del sistema, abajo a la derecha.

Luego la vuelves a abrir con normalidad.

Paso 5 · Comprobar que funciona

Con Claude Desktop abierto:

1. Pulsa el botón + que hay en la parte de abajo del cuadro de chat.
2. Selecciona Conectores.
3. Ahí debería aparecer garmin con su lista de herramientas disponibles.

Si aparece, ya está. La prueba definitiva es escribir en el chat algo como:

«¿Qué tal he dormido esta noche?»

Si te responde con tus datos reales de Garmin, lo tienes funcionando.

Qué puedes preguntarle una vez conectado

El conector da acceso a unas 61 herramientas repartidas en siete categorías: actividades, salud diaria, tendencias, sueño, composición corporal, rendimiento y entrenamiento, y perfil y dispositivos.

Estas son las preguntas que uso yo cada día:

• Por la mañana: «¿Qué tal he dormido? ¿Cómo estoy para entrenar hoy?»
• Antes de salir: «Según mi carga de los últimos días, ¿toca series o zona 2? Dame las series exactas con sus vatios.»
• Después de entrenar: «¿Qué tal ha ido la sesión de hoy? ¿He hecho lo que tocaba?»
• Para entender: «¿Por qué mi Garmin lleva meses diciéndome mantenimiento?»
• Para revisar la configuración: «Revisa mi configuración de Garmin, ¿hay algo mal puesto?» — a mí así me detectó que tenía el dispositivo principal mal seleccionado.

Un consejo: no lo uses como un oráculo. Lee lo que te propone, contrástalo con lo que sientes y con lo que sabes, y si algo no te cuadra, no lo hagas. La gracia de esto no es obedecer, es entender por qué.

Si algo falla

• No aparece garmin en Conectores. Casi siempre es una de dos: no cerraste la app del todo (repite el paso 4) o hay un error de sintaxis en el archivo. Revisa que no falte una comilla, una coma o una llave.
• Aparece pero da error al pedir datos. Comprueba el correo y la contraseña. Y ojo: si tienes verificación en dos pasos activada en Garmin, puede darte problemas de acceso.
• Error al arrancar el conector. Comprueba tu versión de Node.js. Con la 18 hay quien ha tenido fallos; con la 20 o superior va fino.
• No encuentro el archivo de configuración. En Mac la carpeta Library está oculta por defecto: usa el menú Ir → Ir a la carpeta… y pega la ruta, en vez de buscarla a mano.

Preguntas frecuentes

¿Qué es MCP exactamente?

Son las siglas de Model Context Protocol, un protocolo abierto que permite que una inteligencia artificial se conecte con herramientas y fuentes de datos externas. Dicho fácil: es el idioma común que permite que Claude hable con Garmin.

¿Se puede hacer desde el móvil o desde la web?

No. Este método requiere la aplicación de escritorio, porque el conector se ejecuta en tu propio ordenador.

¿Es seguro dar mi contraseña de Garmin?

Los datos no salen a ningún servidor de terceros: el conector se ejecuta en tu ordenador y habla directamente con Garmin. El riesgo real es que la contraseña queda guardada sin cifrar en un archivo local. Por eso conviene usar una contraseña única para Garmin y no hacerlo en un equipo compartido.

¿Puede modificar algo de mi cuenta de Garmin?

El uso normal es de lectura: analiza tus datos. Aun así, revisa siempre qué te propone antes de aceptar cualquier acción.

¿En qué se diferencia de Garmin Connect+?

Garmin tiene su propia función de análisis con IA de pago. La diferencia principal, desde mi experiencia, es que te presenta las métricas de forma más digerible pero no razona contigo: no te explica el porqué de cada decisión ni te resuelve dudas. Aquí puedes preguntar todo lo que quieras y entender lo que estás haciendo.

¿Hay que pagar algo?

El conector es gratuito y de código abierto. Lo que sí necesitas es una cuenta de Claude que te permita usar la aplicación de escritorio con conectores.

¿Funciona con otros asistentes de IA?

Sí. El mismo conector es compatible con cualquier cliente que soporte MCP, no solo con Claude Desktop.

Sigue la serie

🎥 El vídeo donde cuento qué encontró la IA al analizar mis datos y qué he cambiado en mis entrenamientos: míralo aquí

📩 Iré contando mes a mes cómo evoluciona esto, con los números en la mano. Para no perdértelo, únete a la newsletter.

👕 Y si te gusta lo que hago por aquí, échale un ojo a la ropa de Chela Clo.