VReippainen/hevy-mcp-server
If you are the rightful owner of hevy-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A TypeScript Node.js server that connects your Hevy workout data to Language Models via Model Context Protocol (MCP).
Tools
Functions exposed to the LLM to take actions
get-workouts
Get workouts between start and end dates. Returns all workouts if no dates are provided. Returns workouts in descending order of date and limits the number of workouts returned. Max 10 workouts.
Example: { "limit": 5, // Optional: Number of workouts (1-10, default: 10) "startDate": "2024-01-01T00:00:00Z", // Optional: Filter workouts after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Filter workouts before this date }
get-exercise-progress-by-ids
Get progress history for specific exercises between start and end dates. Returns exercise data including weights, reps, and sets for each workout. Results are ordered by date descending. Useful for tracking progress over time for particular exercises.
Example: { "exerciseIds": ["bench-press-123", "squat-456"], // Required: Array of exercise IDs "limit": 5, // Optional: Number of workouts (0-10, default: 10) "startDate": "2024-01-01T00:00:00Z", // Optional: Filter after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Filter before this date }
get-exercises
Get comprehensive exercise data including frequency of use, categorization, and metadata. Results are sorted by usage frequency. Supports filtering by name search and date range.
Example: { "searchTerm": "bench press", // Optional: Filter exercises by name "excludeUnused": true, // Optional: Skip never-performed exercises (default: true) "startDate": "2024-01-01T00:00:00Z", // Optional: Consider usage after this date "endDate": "2024-03-20T23:59:59Z" // Optional: Consider usage before this date }
get-routines
Get user's saved workout routines. Returns all custom and preset routines with their full exercise details, including sets, reps, and rest periods.
Example: {} // No parameters required
Prompts
Interactive templates invoked by user choice
Build me a new workout routine
I will analyze your existing routines and favorite exercises to suggest a new personalized routine.
Resources
Contextual data attached and managed by the client
tools-documentation
URI: file:///tools/documentation
MIME: null
Documentation for all available tools in the Hevy MCP Server
