MCP 服务器

hevy-mcp

Python MCP server for the Hevy fitness app. Gives Claude full access to your Hevy data. Log workouts, manage routines, track body measurements, browse exercises, and more. Covers all 25 endpoints of the official Hevy API.

README

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"