Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chrisdoc/hevy-mcp/llms.txt

Use this file to discover all available pages before exploring further.

Hevy MCP is an open-source Model Context Protocol (MCP) server for the Hevy fitness tracking app. It lets AI assistants read, analyze, create, and update your workouts, routines, exercise templates, and body measurements — all through authenticated Hevy API requests. Connect to the hosted Cloudflare Worker in seconds with no local install, or run the server locally via npx, bunx, or Docker. A Hevy PRO subscription and API key are required.

Quickstart

Connect your first MCP client to Hevy in under five minutes.

Tools Reference

Browse all 25 tools — workouts, routines, exercises, and more.

Connecting Clients

Set up Claude Desktop, Codex, Cursor, or any MCP-compatible client.

Guided Prompts

Use built-in prompts for training analysis and workout logging.

​
How it works

Hevy MCP sits between your AI assistant and the Hevy API. Every tool call is authenticated using your Hevy API key — the server never stores it. 
Hosted:  AI assistant  →  Streamable HTTP  →  Cloudflare Worker  →  Hevy API
Local:   AI assistant  →  MCP over stdio   →  local hevy-mcp     →  Hevy API
Hosted endpoint — The production server runs at https://hevy.chrisdoc.dev/mcp. Send your Hevy API key as a bearer token on every request. Nothing to install or keep running. Local server — Run npx -y hevy-mcp with HEVY_API_KEY in the environment. Works with any stdio MCP client including Claude Desktop, Cursor, and Codex.

​
Get started in three steps

1

Get your Hevy API key

Create an API key in the Hevy app. API access requires a Hevy PRO subscription. Keep the key secure — treat it like a password.
2

Connect your MCP client

Use the hosted endpoint (no install needed) or run locally with npx. See Connecting Clients for client-specific setup.
3

Ask your first question

Try: “Give me a training summary for the last four weeks.” or “What routines do I have saved on Hevy?”

​
What you can do

Analyze training progress

Summarize 1–12 weeks of workouts and body measurements in a single tool call with get-training-summary.

Log and update workouts

Create completed workouts and update existing ones using create-workout and update-workout.

Manage routines

Create, update, and search routines and routine folders to keep your training plans organized.

Search the exercise catalog

Find exercise template IDs by name using search-exercise-templates with a 5-minute catalog cache.
Hevy MCP requires a Hevy PRO subscription for API access. Get your API key from the Hevy app settings before connecting.

Build docs developers (and LLMs) love

Get started for freeTalk to us