Hevy Fitness
A Model Context Protocol (MCP) server implementation that interfaces with the Hevy fitness tracking app and its API. This server enables AI assistants to access and manage workout data, routines, exercise templates, and more through the Hevy API (req
What is Hevy Fitness?
Hevy Fitness is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol (mcp) server implementation that interfaces with the hevy fitness tracking app and its api. this server enables ai assistants to access and manage workout data, routines, exerci...
A Model Context Protocol (MCP) server implementation that interfaces with the Hevy fitness tracking app and its API. This server enables AI assistants to access and manage workout data, routines, exercise templates, and more through the Hevy API (req
This server falls under the Analytics category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol (MCP) server implementation that in
Use Cases
Maintainer
Works with
Installation
NPM
npx -y hevy-mcpManual Installation
npx -y hevy-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Hevy Fitness
hevy-mcp is a Model Context Protocol server that bridges AI assistants such as Claude Desktop and Cursor with the Hevy fitness tracking app API. It allows AI to fetch, create, and update workouts, manage routine folders, browse exercise templates with in-memory caching, and subscribe to workout webhooks — all through natural language. Athletes and developers who log training in Hevy can use this server to analyze progress, generate training plans, and manage routines without leaving their AI assistant.
Prerequisites
- Node.js v24 or higher (version pinned in .nvmrc)
- npm v10 or higher
- A Hevy PRO subscription (required to obtain an API key)
- A Hevy API key from the Hevy app settings
- An MCP-capable client such as Claude Desktop or Cursor
Obtain your Hevy API key
Log in to the Hevy app, navigate to Settings, and generate a PRO API key. The key follows the format sk_live_xxxxxxxx. Keep it secure — it grants full access to your workout data.
Run the server via npx (no install needed)
The quickest way to verify the server works is to run it directly with your API key as an environment variable.
HEVY_API_KEY=sk_live_your_key_here npx -y hevy-mcpAdd to Claude Desktop configuration
Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add the server block.
{
"mcpServers": {
"hevy-mcp": {
"command": "npx",
"args": ["-y", "hevy-mcp"],
"env": {
"HEVY_API_KEY": "sk_live_your_key_here"
}
}
}
}Add to Cursor configuration (alternative client)
Edit ~/.cursor/mcp.json and add the same mcpServers block as above. Restart Cursor to load the server.
Verify the connection
Ask your AI assistant to list your recent workouts. If the server is connected correctly it will return real data from your Hevy account.
Hevy Fitness Examples
Claude Desktop configuration
Complete JSON block for claude_desktop_config.json. Replace the placeholder with your real Hevy PRO API key.
{
"mcpServers": {
"hevy-mcp": {
"command": "npx",
"args": ["-y", "hevy-mcp"],
"env": {
"HEVY_API_KEY": "sk_live_your_key_here"
}
}
}
}Prompts to try
Example prompts that exercise workout retrieval, routine management, exercise templates, and webhook subscriptions.
- "Show me my last 5 workouts and total volume lifted"
- "Create a new Push Day routine with bench press, overhead press, and tricep dips"
- "List all available exercise templates that target the back"
- "How many sets did I do of squats this month?"
- "Set up a webhook to notify me when I complete a workout"Troubleshooting Hevy Fitness
Error: HEVY_API_KEY is missing or invalid
Ensure the env key in your config is exactly HEVY_API_KEY and the value starts with sk_live_. Hevy PRO API keys are only available on a paid subscription — free accounts cannot generate them.
Server starts but returns no workouts
The Hevy API paginates results. If you have no workouts logged in Hevy, there is nothing to return. Try logging a workout in the app first, then ask the assistant again.
Node.js version error on startup
hevy-mcp requires Node.js v24 or higher. Run 'node --version' to check. Install the correct version via nvm: 'nvm install 24 && nvm use 24', then restart your MCP client.
Frequently Asked Questions about Hevy Fitness
What is Hevy Fitness?
Hevy Fitness is a Model Context Protocol (MCP) server that model context protocol (mcp) server implementation that interfaces with the hevy fitness tracking app and its api. this server enables ai assistants to access and manage workout data, routines, exercise templates, and more through the hevy api (req It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Hevy Fitness?
Install via npm with the command: npx -y hevy-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Hevy Fitness?
Hevy Fitness works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Hevy Fitness free to use?
Yes, Hevy Fitness is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Hevy Fitness Alternatives — Similar Analytics Servers
Looking for alternatives to Hevy Fitness? Here are other popular analytics servers you can use with Claude, Cursor, and VS Code.
OpenMetadata
★ 14.0kOpenMetadata is a unified metadata platform for data discovery, data observability, and data governance powered by a central metadata repository, in-depth column level lineage, and seamless team collaboration.
Superset
★ 10.9kAn MCP server that provides AI assistants with full access to Apache Superset instances, enabling interaction with dashboards, charts, datasets, databases, and SQL execution capabilities.
Horizon
★ 4.4k📡 Your own AI-powered news radar. Generates daily briefings in English & Chinese. | 用 AI 构建你专属的新闻雷达
MCP Server Chart
★ 4.1kEnables generation of 25+ types of charts and data visualizations using AntV, including bar charts, line charts, maps, mind maps, and specialized diagrams like fishbone and sankey charts. Supports both statistical charts and geographic visualizations
Muapi CLI
★ 997Official CLI for muapi.ai — generate images, videos & audio from the terminal. MCP server, 14 AI models, npm + pip installable.
Weather MCP Server
★ 907Weather Data Fetcher MCP server built with Node.js, MCP SDK, and Zod. Provides weather details like temperature and forecast for cities such as Noida and Delhi via a registered tool. Simplifies API integration, enabling structured responses for clien
Browse More Analytics MCP Servers
Explore all analytics servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Hevy Fitness in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Hevy Fitness?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.