hevy-mcp

A Python Model Context Protocol (MCP) server for the Hevy fitness app API. Gives Claude (or any MCP-compatible AI) full access to your Hevy workout data — log workouts, manage routines, track body measurements, and more.

Features

• 25 tools covering every endpoint of the Hevy API

• No build step — pure Python, just install and run

• Full CRUD — create, read, update workouts, routines, exercise templates, folders, measurements, and webhooks

Tools

Requirements

• Python 3.10+

• Hevy Pro account (required for API access)

• API key from hevy.com/settings?developer

Installation

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

Configuration

Claude Desktop

Add to claude_desktop_config.json:

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"
      }
    }
  }
}

Restart Claude Desktop. You should see the Hevy server listed under the tools icon in the chat.

Environment variable

Alternatively, set HEVY_API_KEY in your environment and run directly:

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

Usage examples

Once connected, you can ask Claude things like:

• "Show me my last 5 workouts"

• "Log a chest workout I did today — bench press 3x8 at 100kg, incline dumbbell 3x10 at 30kg"

• "Create a Push/Pull/Legs routine"

• "What's my body weight trend over the last month?"

• "Find the exercise template ID for Romanian deadlift"

• "Show me all my bench press sets from the last 3 months"

Tech stack

• FastMCP — Python MCP server framework

• httpx — HTTP client

• Hevy API — official REST API

License

MIT