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-mcp-bridge

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

1. 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.

2. Fülle INTERVALS_API_KEY, INTERVALS_ATHLETE_ID und MCP_PASSWORD aus. Generiere das Passwort mit openssl rand -hex 32.

3. 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 deploy

Mit 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/mcp

Dieser 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

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.

• updateWorkout und deleteEvent sind nur leicht getestet. Die Lesetools und createWorkout sind 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