Controlar tu Garmin desde Claude Code: el servidor MCP para uso personal
¿Quieres leer tus actividades de Garmin y escribir entrenamientos en tu reloj desde el terminal, sin solicitar acceso a la API de Garmin ni programar el cliente OAuth? El servidor MCP de Running Workout se añade a Claude Code con un solo comando. Aquí tienes la instalación, las herramientas expuestas y ejemplos de automatización.
Última actualización: 2026-09-28
Tu Garmin en el terminal
Gratis · conexión oficial con Garmin · entrenamientos enviados a tu reloj
Por qué pasar por un servidor MCP en lugar de la API de Garmin
La API de Garmin no está abierta a particulares: hace falta una cuenta de desarrollador, una aplicación aprobada por Garmin y un servidor que reciba los datos por webhooks. Para un uso personal, es desproporcionado. Running Workout ha hecho ese trabajo y lo expone mediante un servidor MCP: Claude Code, igual que Claude, ChatGPT o Gemini CLI, accede a él con una simple autorización OAuth sobre tu cuenta.
MCP (Model Context Protocol) es el estándar abierto que describe herramientas a un asistente: aquí, leer tus actividades y tu perfil, crear entrenamientos, planificarlos, gestionar un plan. El servidor es de solo lectura sobre tus actividades y únicamente escribe entrenamientos planificados en Garmin Connect.
Pruébalo con tu propio reloj Garmin
Gratis y sin instalar nada: conecta tu Garmin y pide tu primer entrenamiento a Claude o ChatGPT. Llega al reloj en un minuto.
Instalación con un solo comando
Primero crea tu cuenta de Running Workout conectando tu Garmin (activa «Datos históricos» en la pantalla de Garmin). Después, en un terminal donde esté instalado Claude Code:
claude mcp add --transport http running-workout https://www.runningworkout.fr/mcpAbre Claude Code, escribe «/mcp», selecciona running-workout y autentícate: el navegador se abre en runningworkout.fr, validas la pantalla de autorización y aparecen las herramientas. La autorización es un token OAuth propio de Claude Code, revocable desde tus ajustes de Running Workout.
Para compartirlo con un proyecto, la misma configuración puede vivir en el archivo .mcp.json del repositorio, con el transporte http y esta dirección; cada miembro se autentica con su propia cuenta de Garmin.
Las herramientas expuestas
| Herramienta | Qué hace |
|---|---|
| get_athlete_profile | VAM (velocidad aeróbica máxima), FC máx, FTP, carga aguda y crónica (ACWR), valores declarados, últimas notas |
| list_activities, get_activity_details | Las actividades importadas y el detalle de una salida: resumen, vueltas, métricas calculadas |
| create_workout | Un entrenamiento estructurado (carrera, ciclismo, natación) enviado a Garmin Connect, con objetivos de ritmo, FC, potencia o cadencia |
| list_scheduled_workouts, move_scheduled_workout, delete_workout | El calendario de entrenamiento: listar, mover, eliminar |
| set_athlete_data, set_athlete_goal, set_athlete_constraint, add_athlete_note | Memoria del atleta: VAM medida, objetivo de carrera, restricciones (días, lesiones), notas |
| start_training_plan, get_plan_week, review_plan_week, schedule_plan_week | Planes de 5 km a maratón: iniciar, leer la semana, revisarla a posteriori, enviarla al reloj |
Cada herramienta devuelve texto legible por el modelo, con las unidades de tu cuenta (min/km o min/milla). Los errores son explícitos: un objetivo imposible para Garmin se rechaza antes del envío, con los pasos a seguir.
Ejemplos de automatización
El balance de la mañana
claude -p "Lee mi última actividad de Garmin. Resúmela en 5 líneas: distancia, ritmo medio, FC media, deriva cardíaca y un consejo para el próximo entrenamiento."La semana en el reloj
claude -p "Preparo un 10 km para el 15 de noviembre. Monta mi próxima semana (3 sesiones: series, umbral, tirada larga) a partir de mi perfil y envía cada entrenamiento a mi Garmin en su fecha."Un script semanal
El modo no interactivo de Claude Code («claude -p») se lanza desde cron o desde un atajo. Basta una línea el domingo por la noche para recibir el balance de la semana y la propuesta de la siguiente. Mantén la validación humana para el envío al reloj: pide la propuesta, revísala y luego envíala.
El servidor MCP es el mismo que usan Claude en la web, ChatGPT y Gemini CLI. Todo lo que creas desde Claude Code aparece en tu calendario de Running Workout y en Garmin Connect.
Límites y buenas prácticas
- Las actividades llegan por los webhooks de Garmin: una salida aparece unos minutos después de sincronizar el reloj.
- El servidor nunca modifica tus actividades pasadas, solo los entrenamientos planificados.
- Un único objetivo principal por paso en carrera; el ciclismo admite un objetivo secundario (cadencia, FC).
- El formato de Garmin impone límites: la validación del servidor los aplica antes del envío y explica los rechazos.
- Revoca un token desde tus ajustes de Running Workout; cada cliente (Claude Code, Claude web, ChatGPT) tiene el suyo.
Preguntas frecuentes
¿Hace falta una cuenta de desarrollador de Garmin?
No. Running Workout tiene el acceso a la API de Garmin y te lo presta, para tu cuenta, mediante una autorización OAuth. No tienes que pedirle nada a Garmin.
¿Puedo llamar al servidor MCP desde mi propio código, sin Claude?
El servidor sigue el estándar MCP (JSON-RPC sobre HTTP con OAuth 2.1): cualquier cliente MCP conforme puede conectarse. Está pensado para los asistentes, no como una API pública documentada; la página «Escribir un entrenamiento en Garmin por API» describe el formato de los entrenamientos.
¿Funcionan Cursor, Codex u otros agentes?
Cualquier agente que acepte un servidor MCP remoto con autenticación OAuth puede conectarse a la misma dirección. Claude Code, Claude, ChatGPT y Gemini CLI son los que Running Workout prueba.
Tu Garmin en el terminal
Cuenta gratis, un comando en Claude Code, y ya puedes leer tus actividades y enviar tus entrenamientos.
Empezar