Garmin Connect para Claude

Pregúntale a Claude sobre tus datos de Garmin en lenguaje natural.

"¿Cómo dormí anoche?" "Muéstrame mis carreras de las últimas dos semanas." "¿Estoy lo suficientemente recuperado para entrenar duro hoy?" "¿Cuánto corrí el mes pasado comparado con el mes anterior?"

Esto conecta tu cuenta de Garmin Connect con la aplicación Claude Desktop, para que Claude pueda leer tus entrenamientos, sueño, frecuencia cardíaca y otros datos de salud y hablar sobre ellos contigo.

No necesitas saber programar para usar esto. El instalador te hace un par de preguntas y hace el resto.

Lo que necesitas

• Un Mac

• La aplicación Claude Desktop

• Una cuenta de Garmin Connect con un reloj o dispositivo Garmin

Related MCP server: Garmin Connect MCP Server

Instalación

Abre la aplicación Terminal en tu Mac. (Presiona Cmd + Espacio, escribe Terminal, y presiona Enter.)

Copia esta línea, pégala en la ventana de Terminal y presiona Enter:

curl -fsSL https://raw.githubusercontent.com/jharkebusch/garmin-connect-mcp/main/install.sh | bash

Esto hará lo siguiente:

1. Configurará un entorno de Python privado y autocontenido (el Python de tu Mac no se toca)

2. Te pedirá tu correo electrónico y contraseña de Garmin, y el código de seguridad que Garmin te envía

3. Configurará Claude Desktop para ti

Cuando termine, cierra Claude Desktop por completo con Cmd + Q y vuelve a abrirlo. Cerrar la ventana no es suficiente.

Luego solo pregúntale a Claude sobre tus datos de Garmin.

Lo que Claude puede hacer

Salud y bienestar

Entrenamientos y actividades

Registrar cosas (estos modifican tu cuenta de Garmin)

Nada puede eliminar tus datos. No hay ninguna herramienta que elimine una actividad, un entrenamiento o un registro de peso, por lo que una solicitud errónea no puede destruir tu historial de entrenamiento.

Fechas en lenguaje natural

Todas las herramientas entienden expresiones cotidianas, así que puedes hablar con normalidad:

today · yesterday · last night · 3 days ago · last 7 days · this week · last month · 2026-08-18 · 2026-08-01 to 2026-08-18

Tu privacidad y seguridad

• Tu contraseña nunca se guarda. Se usa una vez durante la configuración para iniciar sesión, y luego se descarta.

• Solo se almacenan los tokens de acceso de Garmin, en ~/.garminconnect, como un archivo que solo tu cuenta de usuario puede leer (0600, dentro de una carpeta 0700).

• No se envía nada a ningún sitio excepto a Garmin. No hay telemetría, ni análisis, ni servidores de terceros. Tus datos van de Garmin a tu propio Mac y a ningún otro lugar.

• Todo se ejecuta localmente en tu máquina.

• Tus datos de Garmin solo llegan a Anthropic si Claude los incluye en una respuesta, igual que cualquier otra cosa que escribas en Claude.

Actualización

Ejecuta el mismo comando de instalación de nuevo. Se actualiza en el lugar y mantiene tu sesión iniciada.

Si necesitas iniciar sesión de nuevo

Las sesiones de Garmin se renuevan solas y rara vez caducan. Si Claude alguna vez dice que tu sesión ha caducado, ejecuta esto en Terminal:

garmin-mcp-setup

Si tu Terminal no reconoce ese comando, usa la ruta completa:

~/.garmin-mcp/bin/garmin-mcp-setup

Desinstalación

rm -rf ~/.garmin-mcp ~/.garminconnect ~/.local/bin/garmin-mcp-setup

Luego elimina la entrada "garmin" de la sección mcpServers de ~/Library/Application Support/Claude/claude_desktop_config.json.

Solución de problemas

Claude no ve las herramientas de Garmin. Cierra Claude Desktop por completo con Cmd + Q y vuelve a abrirlo. Cerrar la ventana lo deja ejecutándose en segundo plano.

"Tu cuenta de Garmin aún no está conectada." Ejecuta garmin-mcp-setup en Terminal.

"Demasiadas solicitudes." Garmin limita la velocidad de los intentos de inicio de sesión. Espera unos 15 minutos.

Falta un número en una respuesta. La falta significa que tu dispositivo no lo registró. Algunas métricas (HRV, batería corporal, preparación para el entrenamiento) necesitan un reloj Garmin compatible usado durante la noche. Las herramientas omiten una métrica en lugar de adivinar un valor.

Para desarrolladores

git clone https://github.com/jharkebusch/garmin-connect-mcp.git
cd garmin-connect-mcp
uv venv --python 3.12 && VIRTUAL_ENV=.venv uv pip install -e ".[dev]"
VIRTUAL_ENV=.venv uv run pytest

Estructura:

• src/garmin_mcp/server.py — Servidor MCP y registro de herramientas

• src/garmin_mcp/session.py — Cliente Garmin autenticado, descarga de hilos

• src/garmin_mcp/dates.py — Análisis de fechas en lenguaje natural

• src/garmin_mcp/format.py — Recorta el JSON de Garmin en texto legible

• src/garmin_mcp/tools/ — Las herramientas en sí mismas

• src/garmin_mcp/setup_cli.py — Inicio de sesión interactivo y configuración de Claude

Dos notas de diseño:

• garminconnect es síncrono, por lo que cada llamada se envía a un hilo de trabajo. De lo contrario, una solicitud lenta a Garmin bloquearía todo el servidor.

• El inicio de sesión no puede ocurrir dentro de una llamada de herramienta, porque el paso de dos factores de Garmin necesita un mensaje interactivo. La configuración escribe un archivo de token; el servidor solo lo lee.

Una advertencia que vale la pena conocer

Garmin no publica una API pública. Esto utiliza la misma interfaz que usa la aplicación móvil Garmin, a través de la librería garminconnect. Funciona bien, pero Garmin puede cambiar esa interfaz en cualquier momento y romper temporalmente las herramientas de terceros. Si eso sucede, volver a ejecutar el instalador aplica la corrección una vez que la librería subyacente publique una.

Este proyecto no está afiliado, respaldado ni conectado con Garmin Ltd. Úsalo con tu propia cuenta y tus propios datos.

Licencia

MIT — ver LICENSE.