garmin-claude-mcp
garmin-claude-mcp
Verbinde deine Garmin-Trainingsdaten mit Claude und lass Claude strukturierte Workouts zurück auf deine Uhr schreiben. Kostenlos nutzbar. Kein Abo.
Claude liest deine letzten Aktivitäten und Wellness-Daten, entwirft ein Workout und schreibt es in deinen intervals.icu-Kalender. Intervals.icu synchronisiert es mit Garmin Connect, und es landet auf deiner Uhr.
Warum es so funktioniert
Garmins Entwickler-API ist für Einzelpersonen geschlossen. Anwendungen werden nur für Unternehmen genehmigt, und das Programm ist derzeit für neue Bewerber ausgesetzt. Es gibt zwar inoffizielle Bibliotheken, die sich mit deinem Garmin-Passwort anmelden, aber Garmin hat sie bereits mehrfach funktionsuntüchtig gemacht, indem es seinen Authentifizierungsablauf geändert hat.
Intervals.icu hat eine offizielle Garmin-Partnerschaft, die älter ist als die Schließung des Programms. Es synchronisiert bereits in beide Richtungen, einschließlich des Übertragens geplanter Workouts auf deine Uhr. Außerdem gibt es eine dokumentierte API mit einem persönlichen Schlüssel. Claude spricht also mit intervals.icu, und intervals.icu spricht mit Garmin. Dein Garmin-Passwort verlässt Garmin nie.
Related MCP server: garmin-claude-mcp
Was du brauchst
Ein Garmin-Gerät, das mit Garmin Connect synchronisiert
Ein kostenloses intervals.icu-Konto mit verbundenem Garmin unter Einstellungen > Integrationen, und „Geplante Workouts hochladen“ aktiviert
Deinen intervals.icu-API-Schlüssel und deine Athleten-ID, beide unter Einstellungen > Entwicklereinstellungen
Ein kostenloses Cloudflare-Konto
Wenn „Geplante Workouts hochladen“ deaktiviert ist, funktioniert alles hierunter einwandfrei und nichts wird jemals deine Uhr erreichen. Prüfe das zuerst.
Einrichtung
Option 1: Deploy-Button
Klicke auf den Button oben. Cloudflare fork folgt dieses Repo in dein GitHub, legt den KV-Namespace und das Durable Object an position und fragt dich nach drei Geheimnissen.
Fülle
INTERVALS_API_KEY,INTERVALS_ATHLETE_IDundMCP_PASSWORDaus. Generiere das Passwort mitopenssl rand -hex 32.Deploye. Du erhältst eine URL wie
https://garmin-claude-mcp.<subdomain>.workers.dev.
Option 2: Manuell
git clone https://github.com/kbaudour/garmin-claude-mcp
cd garmin-claude-mcp
npm install
npx wrangler kv namespace create OAUTH_KV
# paste the printed id into wrangler.jsonc
npx wrangler secret put INTERVALS_API_KEY
npx wrangler secret put INTERVALS_ATHLETE_ID
npx wrangler secret put MCP_PASSWORD
npm run deployMit Claude verbinden
Gehe in claude.ai zu Einstellungen > Connectors > Benutzerdefinierten Connector hinzufügen und gib deine Worker-URL mit /mcp am Ende ein:
https://garmin-claude-mcp.<subdomain>.workers.dev/mcpDieser Pfad ist wichtig. Die OAuth-Erkennung liegt unter der Domain-Wurzel. Deshalb funktioniert die Anmeldung selbst mit der falschen URL, und die Verbindung schlägt danach mit „Verbindung zum Server fehlgeschlagen“ fehl. Falls das passiert, lösche den Connector und füge ihn mit dem /mcp-Pfad neu hinzu, anstatt die URL-Taste zu bearbeiten, damit die veraltete Registrierung verworfen wird.
Du siehst eine Passwortseite. Gib dein MCP_PASSWORD ein. Wenn die Verbindung im Web hergestellt ist, funktioniert es auch auf Mobilgeräten.
Tools
Tool | Was es tut |
| Verlauf der letzten Trainingseinheiten |
| Schlaf, HRV, Ruhepuls, Erholungssignale |
| Was bereits im Kalender steht |
| Schreibt ein strukturiertes Workout, das mit Garmin synchronisiert |
| Bearbeitet ein vorhandenes geplantes Workout |
| Entfernt ein geplantes Workout |
Erste Eingabeaufforderung zum Ausprobieren
Pull my wellness data for the last 7 days and my recent activities for the
last 14 days.
Based on what you see there, recovery, training load, how recent runs have
gone, design one run for tomorrow. Walk me through your reasoning before you
create it.
Then create it, and list my upcoming events so I can confirm it landed.Öffne danach Garmin Connect und prüfe das morgige Datum.
Bekannte Probleme und Grenzen
Der kostenlose Plan von Claude erlaubt einen benutzerdefinierten Connector. Das nutzt diesen Steckplatz.
Die Passwortseite hat kein Rate-Limiting und kein CSRF-Token. Das ist ein Server mit einem einzigen Benutzer hinter einem zufälligen 64-Zeichen-Passwort. In Ordnung für diesen Zweck. Keine Produktions-Authentifizierung.
updateWorkoutunddeleteEventsind nur leicht getestet. Die Lesetools undcreateWorkoutsind nachweislich Ende-zu-Ende funktionsfähig, einschließlich Uhr.Tokenaktualisierung über längere Zeiträume ist ungetestet. Wenn der Connector veraltet, dauert das Neuverbinden nur wenige Sekunden.
Jeder mit deiner Worker-URL sieht die Passwortseite. Ohne Passwort kommt niemand weiter, aber die URL ist nicht geheim.
Kosten
$01/Monat. Der kostenlose Tarif von Cloudflare Workers umfasst 100.000 Anträge pro Tag. Der kostenlose Tarif von Intervals.icu beinhaltet die Garmin-Synchronisierung. Durable Objects sind seit April 2025 im kostenlosen Tarif enthalten, daher sind ältere Anleitungen, die das Gegenteil behaupten, veraltet.
Lizenz
MIT
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
Connect Claude to your Intervals.icu watch data for fitness, workout review, and plan writing.
Connect Intervals.icu to Claude and ChatGPT: read training, plan workouts. Training never stored.
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.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read recent Garmin activities and wellness/recovery data and to create, update, or delete structured workouts that sync through intervals.icu to Garmin Connect and the user's watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training and wellness data and create, update, or delete structured workouts through intervals.icu, which syncs planned workouts to Garmin Connect and the user's watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training and wellness data via intervals.icu and create, update, or delete structured workouts that sync to Garmin Connect and a watch.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to read recent Garmin training activities and wellness signals (sleep, HRV, resting HR) and to create, update, or delete structured planned workouts via intervals.icu, which syncs them to Garmin Connect and onto the watch.MIT