garmin-mcp

Habla con tus datos de Garmin. Un servidor MCP de solo lectura que permite a Claude y ChatGPT responder preguntas sobre tu entrenamiento: actividades, sueño, HRV, Body Battery, estado de entrenamiento, clasificaciones de retos - y, a diferencia de otros servidores MCP de Garmin, el archivo FIT original que escribió tu reloj, incluidos los canales de sensores Connect-IQ (Stryd, Moxy/SmO2, CORE).

You:  How did my last long run compare to the same route in June?
You:  Why is my training readiness so low this morning?
You:  Where do I stand in the running challenge, and who is ahead of me?
You:  Did my Stryd actually record power on Tuesday's session?

Nunca escribe en Garmin Connect. Cada herramienta es de solo lectura.

Tres formas de usarlo

1. Acceso de invitado - la única opción que no necesita ninguna infraestructura: abre el enlace de invitación, crea una cuenta, conecta tu Garmin, listo. Igual que la opción 3, funciona con claude.ai en el navegador y con ChatGPT - la opción 2 no puede, porque ninguna de esas puede iniciar un programa en tu ordenador.

El acceso de invitado aún no está abierto. Actualmente funciona con un pequeño grupo de probadores, por invitación personal. Está prevista una forma pública de solicitar una invitación - hasta entonces, las opciones 2 y 3 están listas para usar hoy.

2. Local - nada sale de tu máquina, sin cuentas, sin servidor. Tu cliente de IA inicia el proceso cuando lo necesita. Ideal si ya usas Claude Desktop o Claude Code y quieres mantenerlo todo local.

3. Tu propio servidor - el mismo software que hay detrás del acceso de invitado. Ejecútalo para ti, invita a quien quieras, posee los datos. Consulta docs/self-hosting.md.

Inicio rápido (local)

uv tool install git+https://github.com/mskerwiderski/mcp-garmin

garmin-mcp login

El inicio de sesión pide tu correo electrónico de Garmin, tu contraseña y - si lo usas - tu código multifactor. Almacena únicamente los tokens OAuth de Garmin, en ~/.garmin-mcp/tokens.json con modo 0600. Tu contraseña nunca se escribe en ningún sitio.

A continuación, registra el servidor con tu cliente:

claude mcp add garmin -- garmin-mcp serve

Inicia una nueva sesión y haz una pregunta. Guía completa, incluido Claude Desktop: docs/install-claude.md.

Documentación

Qué puede responder

Actividades - lista y filtra por deporte y fecha, el resumen propio de Garmin de una actividad, y la misma actividad tal como la registró el dispositivo, directamente del archivo FIT. Series temporales para cualquier canal del archivo, detalle de natación en piscina hasta el largo individual, y qué sensores Connect-IQ entregaron datos realmente.

Salud - una llamada al día da pasos, frecuencia cardíaca en reposo, estrés, Body Battery, fases del sueño con puntuación, estado de HRV y preparación para entrenar. Además, estado de entrenamiento con enfoque de carga y VO2max, composición corporal y presión arterial en un rango de fechas.

Tendencias y plan - un mes completo de pasos, Body Battery y VO2max en una sola llamada en lugar de una al día; el lado planificado de Garmin con entrenamientos del plan de entrenamiento y carreras, para poder comparar "lo planificado" y "lo que ocurrió".

Dónde estás - predicciones de carrera de 5k a maratón, edad física, puntuación de resistencia y de cuestas, totales de por vida, y tus récords personales con la actividad que estableció cada uno.

Contexto - tus umbrales y zonas de frecuencia cardíaca, tu equipamiento con las actividades, kilómetros, horas y días que hay detrás, y los retos sociales en los que compites contra amigos, incluido el que está en curso.

Consulta docs/tools.md para ver la lista completa con parámetros.

Por qué el inicio de sesión ocurre en tu máquina

El SSO de Garmin está detrás de Cloudflare, que desde marzo de 2026 responde a los inicios de sesión nuevos desde IPs de centros de datos con 429 o 403. Por eso garmin-mcp login se ejecuta donde estás. El token OAuth1 resultante es válido durante aproximadamente un año y genera tokens de acceso contra connectapi.garmin.com, de modo que nada después del inicio de sesión vuelve a tocar sso.garmin.com.

Un servidor alojado ofrece ambas cosas: un formulario de inicio de sesión (la contraseña se usa una vez y nunca se almacena) y pegar el bloque de token de garmin-mcp export, que es la vía de entrada cuando Garmin bloquea la dirección del servidor.

Cosas que conviene saber

Esto usa la API Connect interna de Garmin - la misma que usan todas las herramientas comunitarias. No existe una API oficial para particulares; la Health API de Garmin es un programa de socios. Usa esto para tu propia cuenta y limita una instancia alojada a personas que realmente conoces: todas las cuentas de un servidor comparten una misma dirección hacia Garmin.

Las respuestas son deliberadamente pequeñas. Garmin responde con cientos de campos por actividad y series temporales de miles de puntos; todo se proyecta a lo que un modelo puede usar realmente, y los flujos se remuestrean con min/max/avg por canal. Eso no es cosmético: las cargas útiles en bruto devorarían la ventana de contexto que la conversación necesita.

Desarrollo

python3.12 -m venv .venv && .venv/bin/pip install -e ".[dev]"

.venv/bin/pytest

103 pruebas, sin acceso a red necesario: la API de Garmin y los archivos FIT están simulados o sintetizados. Consulta docs/architecture.md para ver cómo encajan las piezas.

Licencia

MIT. Consulta LICENSE.