Lets agents manage workouts, routines and exercise templates in the Hevy fitness app (requires PRO).
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add hevy --env HEVY_API_KEY='<HEVY_API_KEY>' -- npx -y hevy-mcp~/.codex/config.toml
[mcp_servers.hevy]
command = "npx"
args = ["-y", "hevy-mcp"]
env = { HEVY_API_KEY = "<HEVY_API_KEY>" }
# codex mcp add hevy --env HEVY_API_KEY='<HEVY_API_KEY>' -- npx -y hevy-mcp~/.cursor/mcp.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"hevy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"hevy": {
"command": "npx",
"args": [
"-y",
"hevy-mcp"
],
"env": {
"HEVY_API_KEY": "<HEVY_API_KEY>"
}
}
}
}Environment variables
HEVY_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.