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

Category	Tools
User	get_user_info
Workouts	get_workouts, get_workout, get_workout_count, get_workout_events, create_workout, update_workout
Routines	get_routines, get_routine, create_routine, update_routine
Routine Folders	get_routine_folders, get_routine_folder, create_routine_folder
Exercise Templates	get_exercise_templates, get_exercise_template, create_exercise_template
Exercise History	get_exercise_history
Body Measurements	get_body_measurements, get_body_measurement, create_body_measurement, update_body_measurement
Webhooks	get_webhooks, create_webhook, delete_webhook

Requirements

• Python 3.12+
• Hevy Pro account (required for API access)
• API key from hevy.com/settings?developer

Installation

git clone https://github.com/srdjancodes/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