Interact with the Hevy fitness API to fetch workouts, workout events, routines, folders, exercise templates, and exercise history. Requires HEVY_API_KEY in .env file. Use when analyzing training history, checking recent workouts, tracking exercise progression, inspecting workout stats, or managing routines and folders.
Interact with a Home Assistant instance through its REST API using curl. Supports reading entity states, controlling smart home devices, calling services for lights, switches, covers, locks, climate, and media players, rendering templates, querying history and logbook data, and firing events. Also supports destructive operations (delete entity, validate config) with mandatory user confirmation. Use when the user asks to check sensors or devices in Home Assistant, turn lights or switches on and off, inspect HA configuration, query automations or entity history, or control smart home devices through the Home Assistant API.
Build and improve Go CLI output, terminal UI, and interactive prompts using PTerm. Use when the user asks to beautify terminal output, add tables, charts, spinners, progress bars, or live areas, add interactive prompts such as confirm, select, multiselect, or text input, improve Go CLI UX, or explain how to use PTerm APIs and options.
Build reusable canvas-based shaders and animated WebGL effects with shaders.com components in frontend projects. Use when adding shader backgrounds, decorative canvas effects, animated hero sections, or layered visual treatments, composing shader nodes, wiring `shaderRenderer` and `createUniformsMap`, or porting a shaders.com setup into Astro, React, Next.js, or plain browser code.
| name | hevy-api |
| description | Interact with the Hevy fitness API to fetch workouts, workout events, routines, folders, exercise templates, and exercise history. Requires HEVY_API_KEY in .env file. Use when analyzing training history, checking recent workouts, tracking exercise progression, inspecting workout stats, or managing routines and folders. |
| metadata | {"tags":"hevy, fitness, workout tracker, workouts, exercise, training, progression, routines, api"} |
This skill provides full access to the Hevy fitness tracking API.
This skill requires a Hevy API key stored in .env:
HEVY_API_KEY=your-api-key-here
If the user doesn't have an API key:
.envhevy-export skill instead (CSV export via browser)All scripts are TypeScript and should be run from the workspace root using the workspace-relative paths below.
npx tsx skills/hevy-api/scripts/fetch-workouts.ts [--days=N] [--limit=N]
Fetches recent workouts with full exercise and set data.
--days=N: Workouts from last N days (default: 30)--limit=N: Max workouts to return (default: 50)Saves to the workspace data/workouts.json file and outputs JSON array.
npx tsx skills/hevy-api/scripts/fetch-workout-count.ts
Returns the total number of workouts on the account: { "workout_count": 42 }.
npx tsx skills/hevy-api/scripts/fetch-workout-events.ts [--since=<ISO8601>]
Returns paginated workout events (updates or deletes) since a given date. Use to keep a local cache up to date without re-fetching all workouts.
--since: ISO 8601 date (default: 1970-01-01T00:00:00Z)Returns a JSON array of events, each with type: "updated" | "deleted" and either a full workout object or { id, deleted_at }.
npx tsx skills/hevy-api/scripts/fetch-user-info.ts
Returns the authenticated user's profile: { id, name, url }.
npx tsx skills/hevy-api/scripts/fetch-routines.ts
Fetches all user routines with full exercise and set data. Saves to the workspace data/routines.json.
npx tsx skills/hevy-api/scripts/fetch-routine.ts --id=<routineId>
Fetches a single routine by ID.
npx tsx skills/hevy-api/scripts/create-routine.ts --routine=<json>
Creates a new routine via POST /routines. The --routine JSON must include:
title (required)folder_id (optional integer)notes (optional)exercises[] — each with exercise_template_id, rest_seconds, notes, sets[]type, weight_kg, reps, distance_meters, duration_seconds, custom_metric, rep_range: { start, end }Returns the created routine.
npx tsx skills/hevy-api/scripts/update-routine.ts --id=<routineId> --routine=<json>
Replaces an existing routine via PUT /routines/{id}. Same JSON shape as Create Routine.
--id: Routine ID (from Fetch Routines)--routine: Full routine JSONReturns the updated routine.
# All templates (cached to workspace `data/exercise_templates.json`)
npx tsx skills/hevy-api/scripts/fetch-exercise-templates.ts
# Single template by ID
npx tsx skills/hevy-api/scripts/fetch-exercise-templates.ts --id=<templateId>
Lists available exercise templates (built-in + custom). Use to look up exercise_template_id values when building routines.
pageSize is 100 per page (max allowed), so most accounts fetch in 1-2 pages.Each template: { id, title, type, primary_muscle_group, secondary_muscle_groups, is_custom }.
npx tsx skills/hevy-api/scripts/create-exercise-template.ts --exercise=<json>
Creates a new custom exercise template via POST /exercise_templates. The --exercise JSON:
title (required)exercise_type: one of weight_reps, bodyweight_reps, weighted_bodyweight, assisted_bodyweight, duration, distance_duration, weight_distance, weight_durationequipment_category: barbell, dumbbell, cable, machine, smith_machine, ez_bar, trap_bar, kettlebell, plate, resistance_band, suspension, other, nonemuscle_group: primary muscle groupother_muscles: array of secondary muscle groupsReturns { id: <newId> }.
# All folders (cached to workspace `data/routine_folders.json`)
npx tsx skills/hevy-api/scripts/fetch-routine-folders.ts
# Single folder by ID
npx tsx skills/hevy-api/scripts/fetch-routine-folders.ts --id=<folderId>
Lists routine folders. Each folder: { id, index, title, updated_at, created_at }.
npx tsx skills/hevy-api/scripts/create-routine-folder.ts --title="Folder Name"
Creates a new routine folder at index 0 (all others shift). Returns the created folder.
npx tsx skills/hevy-api/scripts/fetch-exercise-history.ts --id=<exerciseTemplateId> [--start=<ISO8601>] [--end=<ISO8601>]
Fetches all historical sets logged for a specific exercise (by template ID).
--id: Exercise template ID (required — get from fetch-exercise-templates.ts)--start: Filter from date (e.g. 2024-01-01T00:00:00Z)--end: Filter to date (e.g. 2024-12-31T23:59:59Z)Returns a JSON array of entries: { workout_id, workout_title, workout_start_time, workout_end_time, exercise_template_id, weight_kg, reps, distance_meters, duration_seconds, rpe, custom_metric, set_type }.
npx tsx skills/hevy-api/scripts/analyze-progress.ts --exercise="Exercise Name"
Analyzes progress for a specific exercise over time. Returns volume trends, weight progression, rep improvements, and estimated 1RM changes (Brzycki formula).
npx tsx skills/hevy-api/scripts/check-goal-progress.ts
Compares recent workout performance against goals in the workspace data/goals.md. Returns progress percentage and recommendations.
npx tsx skills/hevy-api/scripts/suggest-updates.ts
Analyzes recent performance and suggests progressive overload, deload, or plateau-breaking changes.
All scripts output JSON to stdout. Parse the output to use in recommendations.
Scripts exit with code 1 and print error JSON if:
See references/HEVY-API.md for full API documentation.