home / mcp / hevy api mcp server

Hevy API MCP Server

Provides an MCP bridge to the Hevy API with tools to manage workouts, routines, and webhook subscriptions.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jcjiron-hevy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hevy-api-mcp"
      ],
      "env": {
        "HEVY_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

This MCP server lets you connect your applications to the Hevy API by running a local MCP broker. It handles authentication, exposes workout, routine, and webhook endpoints, and serves as a bridge between your client code and Hevy’s data and functionality.

How to use

You run the MCP server locally and connect your client to it using standard MCP client tooling. Provide your Hevy API key when starting or via environment variables, and then call the exposed endpoints to fetch workouts, manage routines, or subscribe to webhooks. The server operates as a local bridge that forwards requests to the Hevy API and returns responses to your client.

How to install

# Prerequisites: Node.js and npm
# 1) Clone the project
git clone https://github.com/jcjiron/hevy-mcp.git
cd hevy-mcp

# 2) Install dependencies and build
npm install
npm run build

Additional content

Configuration is driven by environment variables. The official variable you need is HEVY_API_KEY, which holds your Hevy API key. You can provide this key in your shell when starting the server or via a local .env file for development.

Available tools

getWorkouts

Fetch the list of workouts available for the authenticated Hevy account.

getWorkoutById

Retrieve a single workout by its identifier.

createWorkout

Create a new workout with the provided details.

updateWorkout

Update an existing workout with new information.

getRoutineFolders

List routine folders for organizing routines.

getRoutineFolderById

Get a routine folder by its identifier.

createRoutineFolder

Create a new routine folder.

getExerciseTemplates

Fetch predefined exercise templates to base workouts on.

getExerciseTemplateById

Retrieve a specific exercise template by its identifier.

getWebhookSubscription

Fetch a webhook subscription by its identifier.

createWebhookSubscription

Create a new webhook subscription.

deleteWebhookSubscription

Remove an existing webhook subscription.