hevy-mcp-server

Hevy MCP Server

Hevy workout data becomes available to AI assistants through 4 tools covering sessions, exercise progress, exercise details, and saved routines. For Hevy users, a workout prompt builder also supports recommendations informed by their training history.

Server facts

hevy-mcp-server

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
3
Last commit
Data as of

Overview

Hevy training logs provide the basis for reviewing sessions and exercise performance through this TypeScript and Node.js project. The get-workouts tool retrieves up to 10 sessions, places the newest first, and includes duration and volume statistics; date filters narrow the selection. For individual movements, get-exercise-progress-by-ids accepts exercise IDs and returns dated histories of weights, repetitions, and sets, along with records by repetition count. The get-exercises tool ranks movements by how often they appear in training, supports name and date filtering, and supplies exercise metadata plus actual and estimated one-repetition maximums.

Saved training plans are available through get-routines, which returns custom and preset routines with exercise details, set and repetition information, and rest periods. A workout prompt builder combines frequently performed exercises, estimated strength maximums, and detailed routine information to help an assistant formulate personalized workout suggestions. A separate documentation resource explains tool parameters, their accepted ranges and defaults, and example uses. The server obtains data through the Hevy API, requires a Hevy API key, and communicates over stdio.

hevy-mcp-server setup notes

  • hevy-mcp-server records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers