Skip to main content
Glama
garmin-mcp
by saryva

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.

Related MCP server: garmin-mcp

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.

Available Tools

7 tools
garmin_loginA

Inicia sesión en Garmin Connect. Si no pasas email/password, usa las variables de entorno GARMIN_EMAIL/GARMIN_PASSWORD. Si Garmin pide un código de verificación (MFA), vuelve a llamar a esta tool solo con mfa_code relleno.

Inputs: email, mfa_code, password. Returns: result

get_activitiesB

Lista actividades/entrenamientos recientes de Garmin Connect, con distancia, duración, frecuencia cardíaca media y desnivel. Usa activity_type (p. ej. 'running', 'cycling') para filtrar por deporte.

Inputs: limit, start, activity_type.

get_activity_detailA

Detalle de una actividad concreta de Garmin Connect: resumen y splits/parciales. Usa el 'id' devuelto por get_activities.

Inputs: activity_id (required).

get_daily_summaryB

Resumen diario de pasos, calorías y minutos activos. Formato de fecha YYYY-MM-DD. Si no indicas fechas, usa el día de hoy.

Inputs: end_date, start_date.

get_recovery_metricsA

Métricas de recuperación de un día: sueño, Body Battery, HRV y frecuencia cardíaca en reposo. Formato de fecha YYYY-MM-DD; por defecto usa el día de hoy. Para varios días, llama varias veces.

Inputs: day.

get_training_statusB

Estado de forma y carga de entrenamiento: Training Status/Load, VO2 max, récords personales y predicción de tiempos de carrera. Formato de fecha YYYY-MM-DD; por defecto usa el día de hoy.

Inputs: day.

get_training_zonesB

Zonas de frecuencia cardíaca y de potencia configuradas en Garmin Connect.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of Garmin Connect: login, activities, daily summary, recovery, training zones, training status, and activity detail. There is no overlap in purpose.

    Naming Consistency5/5

    All tools use snake_case with a clear 'get_' prefix for queries and a single 'garmin_login' for authentication. The naming pattern is consistent and predictable.

    Tool Count5/5

    Seven tools is well-scoped for a fitness data server, covering login, activity listing, daily summary, recovery metrics, training zones, training status, and activity detail. No tool feels superfluous.

    Completeness4/5

    The tools cover common read operations for Garmin Connect, but lack filtering by date range for activities and batch retrieval for metrics. Minor gaps that do not severely hinder typical use.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to access and query your Garmin Connect data, including sleep, activities, training load, and health metrics, through a set of read-only MCP tools.
      28
      199 PyPI
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects Garmin watch data to Claude Desktop, allowing users to ask natural language questions about their health and activity data from Garmin Connect.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables users to analyze their own Garmin Connect data—activities, sleep, HRV, Body Battery, training readiness—directly inside Claude Desktop.
      13
      1,323 npm
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides Claude Code and Claude Desktop with safe, read-only access to your local Garmin training data, readiness decisions, run details, and trends so you can get coaching advice in natural language.
      15
      99 PyPI
      11
      MIT