Local Garmin Coach MCP

Private, für einen einzelnen Benutzer bestimmte Garmin-Coaching-Tools für Codex/ChatGPT desktop und Claude. Der Server ist nur als lokales stdio verfügbar: kein Cloudflare, Render, keine öffentliche URL, kein Kontodienst und keine Hostingkosten.

Die Laufzeit basiert auf etweisberg/garmin-connect-mcp beim Commit 87d0ea059fb67f1ce65ac05100df74c3c3777c84. Sie behält die Upstream-AGPL-3.0-Lizenz und die Taxuspt-Zuschreibung in NOTICE.

Voraussetzungen

• Node.js 20 oder neuer

• pnpm 10.14.0

• Ein Garmin Connect-Konto und eine synchronisierte Uhr

Related MCP server: io.github.matisdsp/fartlek

Installation

cd /home/talvak/Desktop/repos/garmin-coach-mcp
pnpm install --frozen-lockfile
pnpm exec playwright install chromium
pnpm build
pnpm auth

pnpm auth öffnet ein dediziertes sichtbares Chrome-Profil. Melden Sie sich manuell an, schließen Sie MFA ab und drücken Sie dann im Terminal die Eingabetaste. Die Browsersitzung verbleibt unter ~/.local/share/garmin-coach/browser-profile. CSRF-Werte zur Laufzeit werden von der aktuell authentifizierten Seite gelesen und niemals gespeichert oder ausgegeben. Verzeichnisse haben die Berechtigung 0700, Dateien 0600, das Speichern von Passwörtern ist deaktiviert, und es wird keine Benutzername/Passwort-Datei erstellt.

Garmins Profil-Schreibvertrag erfassen

Garmin veröffentlicht keine stabile API zum Schreiben des Herzfrequenzprofils. Der Server weigert sich, diese zu erraten.

pnpm capture:profile-contract

Der Befehl lädt Garmins aktuelles App-Modell, fordert es auf, die unveränderten aktuellen Standardzonen zu speichern, und blockiert das resultierende PUT vor der Zustellung. Er validiert die Route und den exakt unveränderten Body und speichert dann nur eine geschwärzte Methode/Pfad/Feld-Struktur und unterstützte Scopes in ~/.local/state/garmin-coach/profile-write-contract.json mit Modus 0600.

Wenn Garmins Struktur nicht nachgewiesen werden kann, wird kein Vertrag gespeichert und Profilschreibvorgänge bleiben deaktiviert.

Codex und ChatGPT desktop verbinden

Zuerst bauen, dann config/codex.toml.example nach ~/.codex/config.toml kopieren oder den entsprechenden Server über ChatGPT desktop unter Einstellungen > MCP-Server hinzufügen. Codex CLI, die IDE-Erweiterung und ChatGPT desktop teilen sich die lokale MCP-Konfiguration auf demselben Host.

Das Beispiel verwendet:

default_tools_approval_mode = "writes"

Beide Apply-Werkzeuge haben außerdem explizit approval_mode = "prompt". Starten Sie den Client nach der Konfiguration neu und verwenden Sie /mcp, um die Verbindung zu überprüfen.

ChatGPT web kann diesen lokalen stdio-Prozess nicht starten. Verwenden Sie ChatGPT desktop/Codex für Garmin-Schreibvorgänge.

Claude verbinden

Integrieren Sie config/claude.json.example in Claudes MCP-Konfiguration oder führen Sie Folgendes aus:

claude mcp add garmin-coach -- /home/talvak/snap/code/current/.local/share/pnpm/node /home/talvak/Desktop/repos/garmin-coach-mcp/dist/index.js

Die Dateisystemsperre erlaubt jeweils nur einem lokalen Client, das Garmin-Chromium-Profil zu besitzen. Beenden Sie den Server in einem Client, bevor Sie den anderen verwenden.

Werkzeuge

Sicherer Arbeitsablauf

1. get_coaching_snapshot aufrufen und mit Garmin Connect vergleichen.

2. preview_hr_profile_update aufrufen.

3. Jedes Feld überprüfen und den exakten kanonischen Vorschlag/Hash genehmigen.

4. apply_hr_profile_update aufrufen; dann Garmin synchronisieren und die Zonen der Uhr visuell überprüfen.

5. preview_training_week für eine Woche, die am Sonntag beginnt, aufrufen.

6. Deren Erholungsnachweise, vollständige Nutzlast, Warnungen und Hash überprüfen.

7. apply_training_week mit dem unveränderten kanonischen Vorschlag/Hash aufrufen.

8. verify_training_week aufrufen und bestätigen, dass Montag/Freitag 135-149 bpm sind; Freitag muss feste 12%-Anweisungen anzeigen.

9. Beide Apply-Aufrufe erneut ausführen, um die Idempotenz zu belegen.

Schmerz/Verletzung oder Krankheit blockiert Workout-Schreibvorgänge. Erholung kann beibehalten, reduzieren oder überspringen; sie erhöht niemals die Belastung. Workouts werden nie automatisch gelöscht.

Garmin stellt Laufband als Uhr-Aktivität unter Laufen bereit, nicht als Sportart für strukturierte Workouts. Freitag ist daher ein laufkompatibles Workout namens Incline Walk 12%; starten Sie es aus der Laufband-Aktivität der Uhr. Sein 12%-Steigungshinweis und das Ziel 135-149 bpm bleiben explizit.

Genehmigtes HR-Profil

Diese Werte sind vorläufig: Alter 27, Ruhe-HF 55, geschätzte maximale HF 189 und manueller LTHR 181. Flags für automatische Erkennung bleiben erhalten. Zukünftige Änderungen erfordern eine weitere Vorschau und Genehmigung.

Verifizierung

Normale Tests laufen offline und rufen Garmin nie auf:

pnpm test
pnpm lint
pnpm format:check
pnpm typecheck
pnpm build
git diff --check

Siehe spec.md für das Verhalten und docs/architecture.md für Vertrauensgrenzen.

Lizenz

AGPL-3.0. Siehe LICENSE und NOTICE.