Reads Garmin Connect data such as sleep, HRV, resting heart rate, training load, records, and recent activities, and writes structured workouts with warm-up, main block, cool-down, and pace/heart-rate targets to the user's Garmin watch.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Un entrenador personal de running, fuerza y natación que vive en Claude. Lee tu Garmin, guarda los acuerdos en un contrato con memoria y escribe cada sesión directamente en tu reloj. Viene con zancada, un panel web para mirar desde el móvil cómo vas.
Cada persona lo instala en su propia cuenta de Cloudflare (el plan gratuito basta). Tus datos de sueño, pulso y lesiones no pasan por la instalación de nadie más.
En español. Hecho para una persona por instalación. Garmin es la fuente de datos; intervals.icu es opcional.
Programa contigo, no por ti. Antes de proponer nada lee tus datos reales: sueño, VFC, FC en reposo, carga, marcas y lo que hiciste ayer. Si algo no se pudo leer, lo dice y no programa encima.
Escribe las sesiones en tu reloj, paso a paso (calentamiento, bloque, vuelta a la calma), con objetivos de ritmo o pulso calculados con tus umbrales.
Recuerda lo acordado. Reglas, carreras, pendientes y el nivel de cada lesión viven en un contrato versionado: cada cambio es un commit con su porqué, y el historial no se borra.
Respeta tus límites médicos. Una lesión se guarda como regla protegida: el servidor no deja cambiarla sin tu frase textual, ni siquiera si insistes un día bueno.
Lleva un diario de lo que Garmin no mide (dolor 0-10, síntomas) y lo cruza con la carga.
Te enseña cómo vas en el panel zancada: qué toca hoy, cómo amaneciste frente a tu normal, la semana, tu progreso y el contrato. Solo lectura: todo se escribe hablando con Claude.
Reloj Garmin ─► Garmin Connect ◄──────────┐
│ lee datos, escribe sesiones
Claude (proyecto «Entrenador») ── MCP ──► Tu Worker en Cloudflare ──► D1
│ histórico de Garmin · contrato
Móvil (panel zancada) ──── solo lectura ──┘ diario · materialRelated MCP server: Garmin Coach MCP
INSTALAR.md: unos 30 minutos. Necesitas un reloj Garmin, una cuenta de Claude que admita conectores personalizados, una cuenta de Cloudflare y un ordenador con git y Node 22 o más.
En entrenador/ está lo que se pega en el proyecto de Claude: la constitución (cómo trabaja el entrenador, igual para todos) y una plantilla de perfil (tu entorno y tus objetivos).
Primera conversación: «Hola, empecemos». El entrenador ve el contrato vacío, te entrevista y escribe la primera semana.
Por la mañana | Abre el panel: qué toca hoy, cómo amaneciste frente a tus últimos 120 días y qué límite manda. |
Antes de entrenar | Carga la sesión desde el menú de entrenos del reloj. Si no, el reloj graba una actividad suelta y no sigue los pasos. |
Después | Cuéntale a Claude cómo fue y, si tienes una lesión, el dolor: el mismo día y a las 48 h. Él lo apunta. |
La noche anterior | La sesión siguiente queda escrita. Nunca más de 7 días por delante. |
Tus datos viven en tu D1 y en tu Garmin. El repositorio no lleva datos de
ningún atleta: tu perfil va en tu proyecto de Claude, y tu configuración
(wrangler.jsonc) no se sube.
La URL del conector es una credencial: quien la tenga lee y escribe tu contrato. Guárdala como una contraseña.
La contraseña de Garmin no se guarda nunca. Se usa para enlazar y se olvida; lo que se guarda es el token, cifrado con una clave que no vive en la base de datos.
El panel no puede cambiar el contrato, el diario ni el material. Una cookie robada no reescribe tus acuerdos.
¿Encontraste un fallo de seguridad? Mira SECURITY.md antes de abrir un issue.
Garmin no tiene API pública. La conexión usa la misma vía que su app móvil. Si Garmin cambia su login, puede romperse hasta que se actualice el código. Las cuentas con verificación en dos pasos todavía no se pueden enlazar.
Una instalación, un atleta. Si alguien más quiere el entrenador, que instale el suyo.
Solo en español, de momento: la constitución, el panel y los mensajes.
No es consejo médico. Es una herramienta para entrenar con criterio; ante una lesión que no mejora, al médico.
Instalación paso a paso y cómo actualizar | |
Constitución y plantilla de perfil para el proyecto de Claude | |
Herramientas MCP, contrato, diario, histórico de Garmin, panel, despliegue a mano, notas de diseño | |
Cómo se habla con Garmin sin API pública y por qué funciona | |
Cómo proponer cambios |
npm install
npm run check # tipos
npm test # unitarios
npm run e2e # end-to-end sin red ni credenciales: stub + wrangler dev + D1 localCloudflare Workers + Hono + D1, TypeScript sin más
dependencias en producción. El servidor MCP (streamable HTTP, sin estado) está
escrito a mano en src/mcp/server.ts.
PolyForm Noncommercial 1.0.0: puedes usarlo, estudiarlo, modificarlo y compartirlo para fines no comerciales (uso personal, aficionados, educación, investigación, organizaciones sin ánimo de lucro). Para cualquier uso comercial, pregunta antes. El código y las tipografías de terceros conservan sus licencias: THIRD_PARTY_NOTICES.md.
Proyecto independiente: no está afiliado a Garmin, Anthropic ni intervals.icu.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
AI coach for Garmin: builds training plans and structured workouts, synced straight to your watch.
Garmin watch data for AI assistants: activities, sleep, HRV, recovery. Never writes to Garmin.
Your swim, bike and run training: readiness, HRV, sleep, workouts and race predictions. Read-only.
Training calendar, workouts and health data from Garmin, Wahoo, Polar, Apple Health and more