Deine Garmin aus Claude Code steuern: der MCP-Server für den privaten Gebrauch
Du möchtest vom Terminal aus deine Garmin-Aktivitäten lesen und Workouts auf deine Uhr schreiben, ohne einen Zugang zur Garmin-API zu beantragen oder den OAuth-Client selbst zu schreiben? Der MCP-Server von Running Workout lässt sich mit einem Befehl zu Claude Code hinzufügen. Hier sind die Installation, die bereitgestellten Tools und Beispiele für Automatisierung.
Zuletzt aktualisiert: 2026-09-28
Deine Garmin im Terminal
Kostenlos · offizielle Garmin-Verbindung · Workouts direkt auf deine Uhr
Warum ein MCP-Server statt der Garmin-API
Die Garmin-API steht Privatpersonen nicht offen: Man braucht ein Entwicklerkonto, eine von Garmin genehmigte Anwendung und einen Server, der die Daten über Webhooks empfängt. Für den privaten Gebrauch ist das unverhältnismäßig. Running Workout hat diese Arbeit erledigt und stellt sie über einen MCP-Server bereit: Claude Code greift darauf – wie Claude, ChatGPT oder Gemini CLI – mit einer einfachen OAuth-Autorisierung für dein Konto zu.
MCP (Model Context Protocol) ist der offene Standard, der einem Assistenten Tools beschreibt: hier deine Aktivitäten und dein Profil lesen, Workouts erstellen, sie planen, einen Plan verwalten. Der Server hat auf deine Aktivitäten nur Lesezugriff und schreibt ausschließlich geplante Trainings in Garmin Connect.
Probier es mit deiner eigenen Garmin-Uhr
Kostenlos, ohne Installation: Verbinde deine Garmin und bitte dann Claude oder ChatGPT um dein erstes Workout. In einer Minute ist es auf der Uhr.
Installation mit einem Befehl
Erstelle zuerst dein Running Workout-Konto, indem du dein Garmin-Konto verbindest (aktiviere „Historische Daten“ auf dem Garmin-Bildschirm). Dann in einem Terminal, in dem Claude Code installiert ist:
claude mcp add --transport http running-workout https://www.runningworkout.fr/mcpStarte Claude Code, tippe „/mcp“, wähle running-workout aus und authentifiziere dich: Der Browser öffnet runningworkout.fr, du bestätigst den Autorisierungsbildschirm, und die Tools erscheinen. Die Autorisierung ist ein OAuth-Token eigens für Claude Code, das du in deinen Running Workout-Einstellungen widerrufen kannst.
Um ihn mit einem Projekt zu teilen, kann dieselbe Konfiguration in der Datei .mcp.json des Repositorys liegen, mit dem Transport http und dieser Adresse; jedes Mitglied authentifiziert sich mit seinem eigenen Garmin-Konto.
Die bereitgestellten Tools
| Tool | Was es tut |
|---|---|
| get_athlete_profile | VMA, HFmax, FTP, akute und chronische Belastung (ACWR), angegebene Werte, letzte Notizen |
| list_activities, get_activity_details | Die importierten Aktivitäten, dann die Details eines Laufs: Zusammenfassung, Runden, berechnete Kennzahlen |
| create_workout | Ein strukturiertes Workout (Laufen, Radfahren, Schwimmen), an Garmin Connect gesendet, mit Zielwerten für Pace, HF, Leistung oder Trittfrequenz |
| list_scheduled_workouts, move_scheduled_workout, delete_workout | Der Trainingskalender: auflisten, verschieben, löschen |
| set_athlete_data, set_athlete_goal, set_athlete_constraint, add_athlete_note | Gedächtnis des Athleten: gemessene VMA, Wettkampfziel, Einschränkungen (Tage, Verletzungen), Notizen |
| start_training_plan, get_plan_week, review_plan_week, schedule_plan_week | Pläne von 5 km bis Marathon: starten, die Woche lesen, sie im Nachhinein auswerten, an die Uhr senden |
Jedes Tool gibt für das Modell lesbaren Text zurück, in den Einheiten deines Kontos (min/km oder min/mile). Die Fehler sind eindeutig: Ein Zielwert, den Garmin nicht annehmen kann, wird vor dem Senden abgelehnt – mit dem Hinweis, was zu tun ist.
Beispiele für Automatisierung
Der Morgen-Check
claude -p "Lies meine letzte Garmin-Aktivität. Fasse sie in 5 Zeilen zusammen: Distanz, Durchschnittspace, durchschnittliche HF, Herzfrequenzdrift und ein Tipp für die nächste Einheit."Die Woche auf der Uhr
claude -p "Ich bereite mich auf einen 10-km-Lauf am 15. November vor. Erstelle meine nächste Woche (3 Einheiten: Intervalle, Schwelle, langer Lauf) anhand meines Profils und sende dann jedes Workout zum passenden Datum an meine Garmin."Ein wöchentliches Skript
Der nicht interaktive Modus von Claude Code („claude -p“) lässt sich per cron oder Kurzbefehl starten. Eine Zeile am Sonntagabend genügt, um den Wochenrückblick und den Vorschlag für die nächste Woche zu erhalten. Behalte die menschliche Freigabe für das Senden an die Uhr bei: Fordere den Vorschlag an, lies ihn durch, dann sende.
Der MCP-Server ist derselbe, den Claude im Web, ChatGPT und Gemini CLI nutzen. Alles, was du aus Claude Code heraus erstellst, erscheint in deinem Running Workout-Kalender und in Garmin Connect.
Grenzen und bewährte Vorgehensweisen
- Die Aktivitäten kommen über die Garmin-Webhooks an: Ein Lauf erscheint wenige Minuten nach der Synchronisierung der Uhr.
- Der Server verändert niemals deine vergangenen Aktivitäten, nur die geplanten Trainings.
- Beim Laufen nur ein Hauptziel pro Schritt; beim Radfahren ist ein Zweitziel möglich (Trittfrequenz, HF).
- Das Garmin-Format gibt Grenzwerte vor: Die Validierung des Servers wendet sie vor dem Senden an und erklärt Ablehnungen.
- Widerrufe ein Token in deinen Running Workout-Einstellungen; jeder Client (Claude Code, Claude im Web, ChatGPT) hat sein eigenes.
Häufige Fragen
Braucht man ein Garmin-Entwicklerkonto?
Nein. Running Workout besitzt den Zugang zur Garmin-API und stellt ihn dir für dein Konto über eine OAuth-Autorisierung zur Verfügung. Du musst bei Garmin nichts beantragen.
Kann ich den MCP-Server aus meinem eigenen Code aufrufen, ohne Claude?
Der Server folgt dem MCP-Standard (JSON-RPC über HTTP mit OAuth 2.1): Jeder konforme MCP-Client kann sich verbinden. Er ist für Assistenten gedacht, nicht als dokumentierte öffentliche API; die Seite „Ein Workout per API auf Garmin schreiben“ beschreibt das Format der Workouts.
Funktionieren Cursor, Codex oder andere Agenten?
Jeder Agent, der einen entfernten MCP-Server mit OAuth-Authentifizierung akzeptiert, kann sich mit derselben Adresse verbinden. Claude Code, Claude, ChatGPT und Gemini CLI sind diejenigen, die Running Workout testet.
Deine Garmin im Terminal
Kostenloses Konto, ein Befehl in Claude Code – und du kannst deine Aktivitäten lesen und deine Workouts senden.
Loslegen