Overview
What is Hevy Mcp?
Hevy Mcp is a Python Model Context Protocol (MCP) server that integrates with the Hevy fitness app API. It grants any MCP-compatible AI assistant (like Claude) full access to your Hevy workout data—enabling logging, retrieval, management of workouts, routines, exercises, body measurements, and webhooks.
How to use Hevy Mcp?
Install the server by cloning the repository and running pip install -r requirements.txt (requires Python 3.12+ and a Hevy Pro account). Configure it by adding the server to Claude Desktop’s claude_desktop_config.json, setting the command to python, pointing to the absolute path of server.py, and supplying your Hevy API key via the HEVY_API_KEY environment variable. Alternatively, set the environment variable and run python server.py directly.
Key features of Hevy Mcp
- 25 tools covering every Hevy API endpoint
- Full CRUD for workouts, routines, exercise templates, folders, body measurements, and webhooks
- Pure Python—no build step required
- Seamless integration with Claude Desktop or any MCP-compatible host
Use cases of Hevy Mcp
- Ask your AI to show your last five workouts
- Log a new workout with sets, reps, and weights via natural language
- Create a Push/Pull/Legs routine
- Track your body weight trend over the last month
- Look up exercise template IDs or review bench press history
FAQ from Hevy Mcp
What prerequisites do I need to use Hevy Mcp?
Python 3.12+ and a Hevy Pro account (required for API access). You also need an API key from the Hevy developer settings page.
How do I get an API key for Hevy Mcp?
Go to hevy.com/settings?developer and generate an API key. Provide it as the HEVY_API_KEY environment variable either in your Claude config or directly in your shell.
What transport and authentication does Hevy Mcp use?
It uses standard MCP local transport (via Claude Desktop’s mcpServers configuration) and authenticates with an API key passed as an environment variable. The key is sent with every request to the Hevy API.
Does Hevy Mcp store any of my data locally?
No. The server only communicates with the Hevy API; it does not persist workout data on your machine.
What tools are available in Hevy Mcp?
Twenty-five tools across eight categories: User (get user info), Workouts (list, get, count, events, create, update), Routines (list, get, create, update), Routine Folders (list, get, create), Exercise Templates (list, get, create), Exercise History (get history), Body Measurements (list, get, create, update), and Webhooks (list, create, delete).
