hevy
by mjrussell
Health & FitnessBrief
Query workout data from Hevy including workouts, routines, exercises.
Description
What This Skill Does
A CLI tool for querying and managing workout data from the Hevy fitness tracking app. Connects to the Hevy API to retrieve workouts, routines, exercise templates, and progression history. Supports read and write operations including creating routines and custom exercises.
Exposes Hevy workout data directly in the terminal or to AI agents without opening the mobile app, enabling scripting and automated analysis.
When to Use It
- Checking what exercises were done in the last gym session
- Tracking progress on a specific lift like bench press over time
- Listing saved workout routines before heading to the gym
- Finding exercise IDs by muscle group to build a new routine
- Getting a total workout count for a time period
Example Workflow
User asks: How am I progressing on bench press?
- 1
Run
hevy exercises --search "bench press"to find the exercise template ID - 2
Run
hevy history <exercise-template-id>to retrieve historical sets and weights - 3
Parse the output to identify weight or rep trends over time
A chronological list of bench press sessions showing weight and rep progression
Requirements
- HEVY_API_KEY environment variable
- Hevy Pro subscription (required for API access)
Installation
clawhub install mjrussell/hevyRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.