Manage your Hevy workouts, routines, folders, and exercise templates. Create and update sessions faster, organize plans, and search exercises to build workouts quickly. Stay synced with changes so your training log is always up to date.
Configuration
View docs{
"mcpServers": {
"chrisdoc-hevy-mcp": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "sk_live_XXXXXXXXXXXXXXXXXXXX"
}
}
}
}You gain a practical MCP server that connects to the Hevy Fitness API to access and manage workouts, routines, exercise templates, folders, and webhook subscriptions through an interface that MCP-aware clients can use. It enables you to automate and script interactions with your Hevy data using the Model Context Protocol.
You interact with this server using an MCP-aware client. Start it with your API key and then perform actions such as fetching workouts, creating routines, browsing exercise templates, organizing routine folders, and managing webhook subscriptions for workout events.
Prerequisites you need before installing:
Package manager: pnpm (via Corepack)
A Hevy API key with the appropriate access level
Install and run the server using the following concrete options.
HEVY_API_KEY=your_hevy_api_key_here npx -y hevy-mcpClone the repository, install dependencies, and run locally.
git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp
# Install dependencies via pnpm (require Corepack)
corepack use [email protected]
pnpm install
# Create and populate environment file
cp .env.sample .env
# Edit .env and add HEVY_API_KEY
# Start the server with your API key
HEVY_API_KEY=your_hevy_api_key_here npx -y hevy-mcpConfigure how you connect by setting environment variables or passing command-line arguments. The API key is required to access Hevy data.
To integrate with Cursor, add or merge an MCP server entry under the mcpServers configuration. The stdio-based approach shown here ensures the server runs locally and communicates via standard input/output.
{
"mcpServers": {
"hevy-mcp": {
"command": "npx",
"args": ["-y", "hevy-mcp"],
"env": {
"HEVY_API_KEY": "your-api-key-here"
}
}
}
}Fetch and format workout data from Hevy; supports listing workouts, with optional filters.
Retrieve a single workout by its ID, returning detailed fields.
Create a new workout with specified attributes and associate it with a routine or template as needed.
Update properties of an existing workout, such as name, notes, or metadata.
Return the total number of workouts stored for the connected Hevy account.
Subscribe to or fetch events related to workouts, including updates and deletions.
Fetch and format routine data to review or select existing routines.
Create a new workout routine with its associated exercises and structure.
Modify an existing routine’s details, such as exercises, order, or metadata.
Retrieve a single routine by its unique ID from the Hevy API.
Fetch available exercise templates for building workouts or routines.
Get details for a single exercise template by its ID.
Fetch folders used to organize routines for easier navigation.
Create a new folder to organize routines.
Retrieve a specific routine folder by its ID.
Fetch the current webhook subscription for workout events.
Create a new webhook subscription to receive workout event updates.
Delete the existing webhook subscription for workout events.