hevy-mcp

Ein Python Model Context Protocol (MCP)-Server für die Hevy-Fitness-App-API. Ermöglicht Claude (oder jeder anderen MCP-kompatiblen KI) vollen Zugriff auf Ihre Hevy-Workout-Daten – Workouts protokollieren, Routinen verwalten, Körpermaße verfolgen und mehr.

Funktionen

• 25 Tools, die jeden Endpunkt der Hevy-API abdecken

• Kein Build-Schritt – reines Python, einfach installieren und ausführen

• Vollständiges CRUD – Erstellen, Lesen, Aktualisieren von Workouts, Routinen, Übungsvorlagen, Ordnern, Messungen und Webhooks

Tools

Anforderungen

• Python 3.10+

• Hevy Pro-Konto (erforderlich für API-Zugriff)

• API-Schlüssel von hevy.com/settings?developer

Installation

git clone https://github.com/YOUR_USERNAME/hevy-mcp
cd hevy-mcp
pip install -r requirements.txt

Konfiguration

Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hevy": {
      "command": "python",
      "args": ["/absolute/path/to/hevy-mcp/server.py"],
      "env": {
        "HEVY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Sie sollten den Hevy-Server unter dem Tool-Symbol im Chat sehen.

Umgebungsvariable

Alternativ können Sie HEVY_API_KEY in Ihrer Umgebung festlegen und direkt ausführen:

export HEVY_API_KEY=your-api-key-here
python server.py

Anwendungsbeispiele

Sobald die Verbindung hergestellt ist, können Sie Claude Dinge fragen wie:

• "Zeige mir meine letzten 5 Workouts"

• "Protokolliere ein Brust-Workout, das ich heute gemacht habe – Bankdrücken 3x8 mit 100kg, Schrägbank-Kurzhanteldrücken 3x10 mit 30kg"

• "Erstelle eine Push/Pull/Legs-Routine"

• "Wie ist mein Körpergewichtstrend im letzten Monat?"

• "Finde die ID der Übungsvorlage für rumänisches Kreuzheben"

• "Zeige mir alle meine Bankdrücken-Sätze der letzten 3 Monate"

Tech-Stack

• FastMCP – Python MCP-Server-Framework

• httpx – HTTP-Client

• Hevy API – offizielle REST-API

Lizenz

MIT