Server facts
hevy-mcp-server
Project
- Author
- VReippainen
- Repository
- github.com/VReippainen/hevy-mcp-server
- License
- MIT
- Category
- Data & Analytics
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.