Agent skill · marketing growth · sundial-org

hevy

Query workout data from Hevy including workouts, routines, exercises, and history. Use when user asks about their workouts, gym sessions, exercise progress, or fitness routines.

Why this skill is useful

Provides specific commands and workflows for querying and managing workout data that the AI wouldn't reliably generate on its own.

What it needs

Requires hevy installed locally. Requires hevy account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.

What this skill does

Hevy CLI CLI for the Hevy workout tracking API. Query workouts, routines, exercises, and track progress. Setup Requires Hevy Pro subscription for API access. 1. Get API key from https://hevy.com/settings?developer 2. Set environment variable: export HEVYAPIKEY="your-key" Commands Status Workouts Routines Exercises Exercise History Creating Routines ⚠️ Duplicate Prevention: create-exercise checks if an exercise with the same name already exists and will error if found. Use --force to create anyway (not recommended). Routine JSON format: Other Usage Examples User asks "What did I do at the gym?" User asks "Show me my last chest workout" User asks "How am I progressing on bench press?" User asks "What routines do I have?" User asks "Find leg exercises" User asks "Create a push day routine" Notes Duplicate Prevention: create-exercise checks for existing exercises with the same name before creating. Use --force to override (not recommended). API Limitations: Hevy API does NOT support deleting or editing exercise templates - only creating. Delete exercises manually in the app. API Rate Limits: Be mindful when fetching all data (--all flag) Weights: Defaults to lbs, use --kg for kilograms Pagination: Most commands auto-paginate, but limit flags help reduce API calls IDs: Workout/routine/exercise IDs are UUIDs, shown in detailed views API Reference Full API docs: https://api.hevyapp.com/docs/ Available Endpoints GET /v1/workouts - List workouts (paginated) GET /v1/workouts/{id} - Get single workout GET /v1/workouts/count - Total workout count GET /v1/routines - List routines GET /v1/routines/{id} - Get single routine GET /v1/exercisetemplates - List exercises GET /v1/exercisetemplates/{id} - Get single exercise GET /v1/exercisehistory/{id} - Exercise history GET /v1/routinefolders - List folders Write Operations (supported but use carefully) POST /v1/workouts - Create workout PUT /v1/workouts/{id} - Update workout POST /v1/routines - Create routine PUT /v1/routines/{id} - U …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sundial-org/hevy

View the source on GitHub

Browse the @skills marketplace