Hevy MCP Server

Name: Hevy MCP Server
Author: VReippainen

@VReippainen

Repository

About Hevy MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hevy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@vreippainen/hevy-mcp-server",
        "--stdio"
      ],
      "env": {
        "HEVY_API_KEY": ""
      }
    }
  }
}

Tools

Get workouts between start and end dates. Returns workouts in descending order of date with duration and volume stats. Max 10 workouts.

Track progress for specific exercises over time, filtered by date range. Returns also records per reps.

Get comprehensive exercise data sorted by frequency of use, with optional filtering by name and date range. Returns also actual and estimated 1RM.

Retrieve your saved workout routines

Overview

What is Hevy MCP Server?

Hevy MCP Server is a TypeScript Node.js server that connects your Hevy workout data to language models via the Model Context Protocol (MCP). It fetches data from the Hevy API and provides tools for accessing workout history, exercise progress, and personal records, enabling AI assistants to analyze your workout data.

How to use Hevy MCP Server?

Install and invoke by adding a configuration to your ~/.cursor/mcp.json file using npx and setting the HEVY_API_KEY environment variable. Then use the provided tools (e.g., get-workouts, get-exercises) through an MCP‑compatible client.

Key features of Hevy MCP Server

get-workouts: Retrieve up to 10 workouts within a date range with duration and volume stats.
get-exercise-progress-by-ids: Track progress for specific exercises over time, filtered by date range.
get-exercises: Get comprehensive exercise data sorted by frequency, with optional name and date filtering.
get-routines: Retrieve your saved workout routines.
Workout prompt builder: Analyzes frequent exercises and routines to help AI create personalized recommendations.

Use cases of Hevy MCP Server

An AI assistant queries your recent workout history to suggest recovery adjustments.
Automatically track progress on specific exercises over a chosen time period.
Generate personalized workout plans based on your most-used exercises and saved routines.
Retrieve and review your saved workout routines for planning or analysis.