garmin-mcp
This server provides read-only access to your Garmin Connect fitness data, exposing it to Claude for analysis and insights.
Authentication (
garmin_login): Log in using email/password or environment variables, with MFA support.List Recent Activities (
get_activities): Retrieve recent workouts including distance, duration, average heart rate, and elevation gain, with filtering by sport type (e.g., running, cycling).Activity Detail (
get_activity_detail): Get detailed information about a specific activity, including full summary and splits/lap data.Daily Summary (
get_daily_summary): Fetch daily stats such as steps, calories burned, and active minutes for a given date range.Recovery Metrics (
get_recovery_metrics): Access sleep data, Body Battery level, HRV (Heart Rate Variability), and resting heart rate for a specific day.Training Zones (
get_training_zones): View your configured heart rate and power training zones.Training Status (
get_training_status): Check training load/status, VO2 max estimate, personal records, and race time predictions.
Provides read-only access to Garmin Connect data, including activities, activity details, daily summaries, recovery metrics, training zones, and training status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@garmin-mcp how did I sleep last night?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Descarga
mcp-garmin.mcpbde la última release.En Claude Desktop: Configuración → Extensiones → "Install Extension…" → selecciona el fichero.
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 pasaAñ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 (editandoclaude_desktop_config.json/.mcp.jsono el.env):GARMIN_PASSWORDse 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
uven la máquina destino: el.mcpbusa"type": "uv"como runtime, lo que evita tener que preinstalar Python o Node en la máquina, pero no evita necesitaruv:uvdebe estar instalado en la máquina donde se instale la extensión para quemcpbpueda ejecutar el servidor.
Available Tools
7 toolsgarmin_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Garmin watch data for AI assistants: activities, sleep, HRV, recovery. Never writes to Garmin.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.28199 PyPI5MIT
- FlicenseNot gradedqualityDmaintenanceConnects Garmin watch data to Claude Desktop, allowing users to ask natural language questions about their health and activity data from Garmin Connect.-
- AlicenseBqualityBmaintenanceEnables users to analyze their own Garmin Connect data—activities, sleep, HRV, Body Battery, training readiness—directly inside Claude Desktop.131,323 npm2MIT
- AlicenseAqualityBmaintenanceProvides 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.1599 PyPI11MIT