LaunchKit · 2026
Back to Skills

Query workout data from Hevy including workouts, routines, exercises.

2
2.2k downloads
by @mjrussell

Setup & Installation

openclaw skills install @mjrussell/hevy

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install hevy

Version History

v0.2.0Jan 12, 2026 - Version note by skill developer:

Add duplicate check to create-exercise command - prevents creating exercises with same name unless --force flag used. Document API limitations (no DELETE/PUT for exercises).

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

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: How am I progressing on bench press?

AGENT
  1. 1Run `hevy exercises --search "bench press"` to find the exercise template ID
  2. 2Run `hevy history <exercise-template-id>` to retrieve historical sets and weights
  3. 3Parse the output to identify weight or rep trends over time
OUTPUT

A chronological list of bench press sessions showing weight and rep progression

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

HEVY_API_KEY environment variableHevy Pro subscription (required for API access)