hevy-mcp

Overview

hevy-mcp is a TypeScript-based MCP server that provides AI assistants with programmatic access to the Hevy fitness tracking platform. It allows Claude Desktop and Cursor users to interact with their fitness data through a suite of well-documented MCP tools. The server supports workout management, routine organization, exercise template browsing, and webhook subscriptions, with proper error handling and in-memory caching for exercise templates to optimize performance.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get-workouts

  Fetch all workouts from your Hevy account

  Try:Get my last 5 workoutsTry:Show me all my workouts this month
• get-workout

  Retrieve a specific workout by its ID

  Try:Get my workout from yesterdayTry:Show me workout ID 12345
• create-workout

  Create a new workout session

  Try:Create a new chest and triceps workoutTry:Add a new leg day workout
• update-workout

  Update an existing workout with new data

  Try:Update my workout ID 12345 with more setsTry:Modify my yesterday's workout
• get-workout-count

  Get the total count of workouts in your account

  Try:How many workouts have I logged?Try:Show me my workout total
• get-workout-events

  Fetch workout events from your account

  Try:What workout events do I have?Try:Show me my recent workout events
• get-routines

  Retrieve all workout routines from your account

  Try:Show me all my workout routinesTry:List all my saved routines
• get-routine-by-id

  Get a specific routine by its ID

  Try:Show me routine ID 54321Try:Get details for my strength routine
• create-routine

  Create a new workout routine

  Try:Create a new push-pull-legs routineTry:Add a full body beginner routine
• update-routine

  Update an existing workout routine

  Try:Update my routine ID 54321 with new exercisesTry:Modify my upper body routine
• get-exercise-templates

  Fetch available exercise templates

  Try:Show me all exercise templatesTry:Get me back exercise options
• search-exercise-templates

  Search for exercise templates with specific criteria

  Try:Find chest press exercisesTry:Search for back row variations

Comparable tools

Installation

HEVY_API_KEY=sk_live... npx -y hevy-mcp

git clone https://github.com/chrisdoc/hevy-mcp.git
cd hevy-mcp
npm install
cp .env.sample .env
# Edit .env and add your HEVY_API_KEY

{
  "mcpServers": {
    "hevy-mcp": {
      "command": "npx",
      "args": ["-y", "hevy-mcp"],
      "env": {
        "HEVY_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

FAQ

Does this work with the free version of Hevy?

No, a Hevy PRO subscription is required to access the API.

Which AI assistants are compatible with hevy-mcp?

It's designed to work with Claude Desktop and Cursor, but should work with any MCP client that supports stdio transport.

Compare hevy-mcp with