Provides tools for managing workout data through the Hevy API, including creating and updating workouts, managing routine folders, accessing exercise templates, and configuring webhook subscriptions for fitness tracking.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hevy MCP Servershow my recent workouts"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
hevy-api-mcp
MCP server for the Hevy API
Installation
Clone the repository and navigate to the directory:
git clone https://github.com/jcjiron/hevy-mcp.git cd hevy-mcpInstall dependencies and build:
npm install npm run build
Related MCP server: Strava MCP Server
Usage with npx
You can run the MCP server using npx (locally or globally, if published to npm):
Or from your MCP config:
Environment variables
HEVY_API_KEY: Your Hevy API key (required).
You can use a .env file for local development:
Exposed tools
getWorkouts
getWorkoutById
createWorkout
updateWorkout
getRoutineFolders
getRoutineFolderById
createRoutineFolder
getExerciseTemplates
getExerciseTemplateById
getWebhookSubscription
createWebhookSubscription
deleteWebhookSubscription
Usage example
You can test the server locally:
Or using the .env file:
For questions or suggestions, open an issue in the repository.