hevy-api-mcp

MCP server for the Hevy API

Installation

1. Clone the repository and navigate to the directory:

   git clone https://github.com/jcjiron/hevy-mcp.git
   cd hevy-mcp

2. Install dependencies and build:

   npm install
   npm run build

Related MCP server: hevy-mcp-server

Usage with npx

You can run the MCP server using npx (locally or globally, if published to npm):

npx hevy-api-mcp

Or from your MCP config:

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

Environment variables

• HEVY_API_KEY: Your Hevy API key (required).

You can use a .env file for local development:

HEVY_API_KEY=your_api_key

Exposed tools

• getWorkouts

• getWorkoutById

• createWorkout

• updateWorkout

• getRoutineFolders

• getRoutineFolderById

• createRoutineFolder

• getExerciseTemplates

• getExerciseTemplateById

• getWebhookSubscription

• createWebhookSubscription

• deleteWebhookSubscription

Usage example

You can test the server locally:

HEVY_API_KEY=your_api_key npx hevy-api-mcp

Or using the .env file:

npx hevy-api-mcp

For questions or suggestions, open an issue in the repository.