garmin-coach-mcp
Connects to a user's own Garmin Connect account to retrieve activities, splits, heart-rate and power zones, aerobic decoupling, HRV, sleep, stress, readiness, training status, gear, personal records, and session weather, and to create, schedule, inspect, and delete running, strength, and swim workouts.
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.
garmin-coach-mcp
A remote MCP server that connects Claude (or any MCP client) to your own Garmin Connect account: activities, splits, HR and power zones, aerobic decoupling, HRV, sleep, stress, readiness, training status, gear, personal records, session weather — and it can create, schedule and delete running, strength and swim workouts on your watch.
It runs in the cloud, so it also works from the Claude mobile app.
Español: instrucciones al final.
Want coach-grade analysis on top of the data? The Garmin Run Coach skill on Agensi teaches your agent to use these tools well: decoupling on the steady block, weather-corrected heart rate, readiness calls and workouts that upload cleanly.
How it stays private
Everyone deploys their own copy. Your Garmin credentials live only in your Render account's environment variables. This repo contains no credentials and no personal data.
The connector URL is the key. Render generates a random
MCP_SECRET; the endpoint ishttps://<your-service>.onrender.com/mcp/<secret>. Without it, the server answers nothing but/health. The server refuses to start in the cloud without a secret.Nothing is sent anywhere else, except Open-Meteo (coordinates and time only) when you ask for session weather.
Related MCP server: Daash
Setup (about 10 minutes)
Deploy. Click Deploy to Render (free account). Render asks for:
GARMIN_EMAIL,GARMIN_PASSWORD— your Garmin Connect login. Works directly if your account has no two-factor authentication (MFA).GARMIN_TOKENS— leave empty, unless your account uses MFA (see below).LOCAL_TZ_OFFSET_HOURS— your offset from UTC (e.g.-5,-6,1).MCP_SECRETis generated for you.
Get your connector URL. When the deploy is Live, open the service's Logs: the server prints
Conector MCP: https://<tu-servicio>.onrender.com/mcp/.... Replace<tu-servicio>with your service's address (shown at the top of the Render page). Keep this URL private.Add it to Claude. claude.ai (web) → Settings → Connectors → Add custom connector → paste the URL. It then works in the web, desktop and mobile apps. Test with "check my Garmin connection".
Keep it awake (recommended). Render's free plan sleeps after 15 minutes without traffic. Create a free UptimeRobot HTTP(s) monitor on
https://<your-service>.onrender.com/healthevery 5 minutes. Use only/healththere, never the URL with your secret. One always-on service fits Render's 750 free hours a month.
Accounts with MFA: run garmin_login.py on your computer, or open
garmin_login_colab.ipynb in Google Colab from your phone. Paste the printed value into
GARMIN_TOKENS in Render. Treat it like a password.
Tools (41)
Group | Tools |
Activities | list, by date, last, full analysis (summary, splits, typed splits, zones, optional weather), compare, progress summary, personal records |
Derived metrics | aerobic decoupling Pa:HR / Pw:HR on the active block, cardiac drift, HR recovery, HR curve |
Daily physiology | morning check, HRV (+detail), sleep, stress, Body Battery events, daily summary, altitude vitals, body composition, hydration |
Trends |
|
Intraday | heart rate and stress for a time window |
Status | training status (load, ACWR, load balance, acclimation, race predictions), calibration (LTHR, threshold pace/power, VO2max) |
Strength & swim | session detail, exercise search and validation |
Writing | create running/strength/swim workouts, inspect, delete, calendar, schedule/unschedule, gear, set activity gear |
Session weather (include_weather=true in the activity analysis): Garmin uses its nearest
weather station, which can be tens of km away. The server also queries Open-Meteo at the run's
GPS point for the hours nearest start and end, and warns when Garmin's station is > 15 km away.
Tool descriptions are in Spanish; Claude answers in your language anyway.
Important
Unofficial access. This uses
python-garminconnect, which talks to Garmin Connect the way the website does. It is not affiliated with or endorsed by Garmin, and Garmin can change or block it at any time. Use it with your own account only. Garmin also offers an official Personal API (read-only, your own data).Not a medical device. Heart-rate metrics are training indicators, not clinical measurements.
Exercise catalog. Strength exercise names are validated against a catalog generated at build time from Garmin's official
garmin-fit-sdkpackage (FIT Protocol License). It is not included in this repo.Open-Meteo is free for non-commercial use; personal analysis of your own runs fits that.
Run locally
pip install -r requirements.txt "garmin-fit-sdk>=21,<22"
python build_exercise_catalog.py
export GARMIN_EMAIL="..." GARMIN_PASSWORD="..." # or GARMIN_TOKENS
HOST=127.0.0.1 PORT=8000 python garmin_mcp_server.py # MCP at http://127.0.0.1:8000/mcpLicense
MIT for the code in this repo. See LICENSE.
Español
Servidor MCP para conectar Claude con tu propia cuenta de Garmin Connect. Cada persona despliega su copia; tus credenciales quedan solo en tu cuenta de Render. Para análisis de entrenador sobre estos datos, existe el skill Garmin Run Coach en Agensi.
Pulsa Deploy to Render. Escribe tu correo y contraseña de Garmin (cuentas sin verificación en dos pasos) y tu desfase horario (Bogotá/Lima
-5, Ciudad de México-6). El secretoMCP_SECRETse genera solo.Cuando diga Live, abre Logs y copia la línea
Conector MCP: .... Cambia<tu-servicio>por la dirección de tu servicio. Esa URL es tu llave: no la compartas.En claude.ai (web) → Ajustes → Conectores → Agregar conector personalizado → pega la URL.
Opcional: un monitor gratis de UptimeRobot a
.../healthcada 5 minutos para que no se duerma.
Si tu cuenta usa verificación en dos pasos, genera GARMIN_TOKENS con
garmin_login_colab.ipynb (Google Colab, funciona desde el celular).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Garmin data in Claude & ChatGPT via the Garmin Health API. OAuth sign-in, no password sharing.
Garmin data in Claude: 135 tools — activities, sleep, HRV, training, workouts. Free, open source.
tri-train is a training platform for triathletes that syncs activities from Strava and Garmin and exposes them to Claude through a remote MCP server. Ask Claude how your last block went, why your run pace dropped, or whether you are fresh enough for Sunday's race, and it answers from your real data: activities with laps and grade-adjusted pace, weekly load and the performance management chart (CTL/ATL/TSB), sleep, HRV and resting heart rate, and your race calendar with predictions. Claude can also act: create and adjust planned workouts with structured intervals, push them to your Garmin watch, add races and write notes. Every change is journaled and can be undone. Read and write access are separate OAuth scopes, and the server enforces them on every call. Built and hosted in Switzerland by a triathlete; data stays on our own servers (Swiss revDSG / GDPR).
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceConnects Claude to Garmin Connect to view fitness data and create adaptive training plans for running, swimming, cycling, and strength. Supports both local and VPS deployment with optional Supabase storage.-
- AlicenseAqualityBmaintenanceDaash connects Garmin Connect to ChatGPT and Claude. Your assistant reads your runs, splits, sleep, HRV, Body Battery and recovery, and writes structured workouts and whole training plans to your Garmin calendar, so they're on your watch at the next sync. Free, hosted, open source. Works on free Claude.266MIT
- AlicenseBqualityBmaintenanceEnables Claude to access and query your Garmin Connect data—sleep, training, heart rate, and more—through a suite of read-only tools, with an optional write path for creating strength workouts.63MIT
- AlicenseNot gradedqualityNot gradedmaintenanceConnects Garmin training data to Claude so it can read recent activities, wellness and recovery signals, and upcoming calendar events. It also lets Claude create, update, and delete structured workouts that sync through intervals.icu to Garmin Connect and onto the user's watch.MIT