Hevy MCP Server — Claude Code MCP server: features and setup
Connect an AI assistant to Hevy workout records to review training history or manage entries. You’ll need a Hevy API key and a Hevy PRO subscription.
claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpWhat Hevy MCP Server does
Hevy MCP Server lets an assistant read and analyze workouts, routines, exercise templates, and body measurements through the Hevy API. It can also create or update those records. Ask about training patterns across several weeks, or look up the exercises in a saved routine.
The server works with Claude Code, Codex, Cursor, and the other listed MCP clients. For a local setup, run it with npx and provide the HEVY_API_KEY environment variable. Hevy PRO is required for API access, so the connection depends on that subscription.
What it helps with
- summarize workouts over a selected period
- spot frequently trained exercises and gaps in a routine
- inspect exercises and sets in a saved routine
- create a workout or update body measurements
Example prompts for the agent
- Review my workouts from the last few weeks and identify the exercises I train most often.
- Find my chest-day routine and list its exercises and sets.
- Create a completed workout from a saved routine, and ask me for any missing set results.
How to install Hevy MCP Server
Platform CLI
claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpReplace <…> with your own values
Platform CLI
codex mcp add hevy-mcp-server --env HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"hevy-mcp-server": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"hevy-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HEVY_API_KEY=<HEVY_API_KEY> hevy-mcp-server npx -y hevy-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Hevy MCP Server
How do I install Hevy MCP Server in Claude Code?
Set your Hevy API key, then add the server with claude mcp add hevy-mcp -e HEVY_API_KEY=<HEVY_API_KEY> -- npx -y hevy-mcp. Hevy PRO is required for API access.
What does Hevy MCP Server do?
It connects an AI assistant to the Hevy API so the assistant can read and analyze workouts, routines, exercise data, and body measurements, as well as create or update records.
What do I need to use Hevy MCP Server?
You need a Hevy API key, and API access requires a Hevy PRO subscription.
