Minimal Hevy MCP

Ein kleiner lokaler Server für das Model Context Protocol, der es einem Agenten ermöglicht, Hevy-Workout-Daten zu lesen und über die öffentliche API von Hevy Workout-Routinen zu erstellen.

Enthaltene Tools

• hevy_list_workouts

• hevy_get_workout

• hevy_list_routines

• hevy_get_routine

• hevy_search_exercises

• hevy_get_exercise_history

• hevy_create_workout

• hevy_create_routine

Die ersten sechs Tools sind schreibgeschützt. hevy_create_workout und hevy_create_routine schreiben in das verbundene Hevy-Konto und sind als nicht-idempotente Mutationen gekennzeichnet.

hevy_create_routine erstellt einen wiederverwendbaren Plan für eine zukünftige Trainingseinheit. hevy_create_workout protokolliert eine bereits abgeschlossene Trainingseinheit mit den tatsächlichen Start- und Endzeiten sowie den Satzergebnissen. Es setzt abgeschlossene Workouts standardmäßig auf privat und lehnt auch Sätze ohne aufgezeichnete Leistungsmetrik ab.

Related MCP server: hevy-mcp-server

Voraussetzungen

• Node.js 20 oder neuer

• Ein Hevy-Pro-Konto und ein API-Schlüssel von https://hevy.com/settings?developer

Installation und Validierung

npm install
npm run check
npm run build
npm run smoke

Lokal ausführen

export HEVY_API_KEY="your-key"
npm start

Der Server kommuniziert über stdin/stdout und scheint daher bei direkter Ausführung still zu warten. Ein MCP-Host soll ihn starten und mit ihm kommunizieren.

Zu Codex hinzufügen

Baue zuerst den Server, mache HEVY_API_KEY in der Umgebung verfügbar, die Codex startet, und führe dann Folgendes aus:

codex mcp add hevy -- node /absolute/path/to/hevy-mcp/dist/index.js

Starte Codex nach dem Hinzufügen des Servers neu. Überprüfe die Konfiguration mit:

codex mcp list

Commite den API-Key nicht und übergib ihn nicht als Tool-Argument. Der MCP liest ihn ausschließlich aus HEVY_API_KEY und sendet ihn an Hevy im erforderlichen api-key-Header.

Empfohlene erste Anfrage

Lies meine fünf letzten Workouts und fasse Häufigkeit, Übungsauswahl und offensichtliche Fortschrittsmuster zusammen. Erstelle oder aktualisiere nichts.

Wenn du den Agenten bittest, eine Routine zu erstellen, verlange, dass er die vollständige Routine zeigt und deine Zustimmung einholt, bevor er hevy_create_routine aufruft.

Wenn du einen abgeschlossenen Workout protokollierst, gib dem Agenten die tatsächlichen Übungen, Satzergebnisse und Zeiten an. Verlange, dass er den vollständigen Workout zeigt und deine Zustimmung einholt, bevor er hevy_create_workout aufruft. Der Agent darf sich abgeschlossene Ergebnisse niemals ausdenken.