MCP Garmin

Servidor MCP que expone tus datos de Garmin Connect (actividades, sueño, recuperación, estado de forma) a Claude, en modo solo lectura.

Instalación rápida (Claude Desktop, sin terminal)

1. Descarga mcp-garmin.mcpb de la última release.
2. En Claude Desktop: Configuración → Extensiones → "Install Extension…" → selecciona el fichero.
3. Rellena tu email y contraseña de Garmin Connect en el formulario. Se guardan solo en tu máquina.

Instalación para desarrollo

git clone <url-del-repo>
cd mcp-garmin
cp .env.example .env   # rellena tus credenciales
uv sync
uv run pytest          # verifica que todo pasa

Añade el servidor a tu claude_desktop_config.json o .mcp.json apuntando a uv run --directory <ruta-del-repo> src/server.py.

Tools disponibles

• garmin_login(email, password, mfa_code) — inicia sesión (con soporte MFA).
• get_activities(start, limit, activity_type) — actividades recientes.
• get_activity_detail(activity_id) — detalle y splits de una actividad.
• get_daily_summary(start_date, end_date) — pasos, calorías, minutos activos.
• get_recovery_metrics(day) — sueño, Body Battery, HRV, FC en reposo.
• get_training_zones() — zonas de FC y potencia configuradas.
• get_training_status(day) — Training Load/Status, VO2 max, récords, predicciones.

Alcance

Solo lectura. La escritura de entrenamientos hacia el dispositivo queda fuera de esta versión (ver docs/superpowers/specs/2026-07-27-garmin-mcp-connector-design.md).

Notas sobre credenciales y requisitos

• Instalación vía .mcpb: Claude Desktop guarda tu email y contraseña de Garmin usando el keychain del sistema operativo (cifrado). Instalación manual (editando claude_desktop_config.json / .mcp.json o el .env): GARMIN_PASSWORD se guarda tal cual, en texto plano, en ese fichero. Es un compromiso asumido para simplificar el flujo de desarrollo/manual; ten cuidado con los permisos de esos ficheros y no los subas a un repo.
• Requisito de uv en la máquina destino: el .mcpb usa "type": "uv" como runtime, lo que evita tener que preinstalar Python o Node en la máquina, pero no evita necesitar uv: uv debe estar instalado en la máquina donde se instale la extensión para que mcpb pueda ejecutar el servidor.