Skip to main content
The Hevy HTTP MCP server provides tools for managing routine folders. Folders help you organize your routines into logical groups (e.g., “Push/Pull/Legs”, “Powerlifting”, “Bodybuilding”).

​
get-routine-folders

Fetch a paginated list of routine folders from your Hevy account.

​
Parameters

​
page
number
Page number (default: 1)
​
pageSize
number
Items per page (default: 5, max: 10)

​
Response

​
page
number
Current page number
​
page_count
number
Total number of pages available
​
routine_folders
array
Array of routine folder objects

​
Example

{
  "page": 1,
  "pageSize": 5
}

​
get-routine-folder

Get a single routine folder by its ID.

​
Parameters

​
folderId
number
required
The routine folder ID

​
Response

Returns a single routine folder object with the same structure as described in get-routine-folders.

​
Example

{
  "folderId": 1
}

​
create-routine-folder

Create a new routine folder to organize your routines.

​
Parameters

​
title
string
required
Folder title

​
Response

Returns the created routine folder object.

​
Example

{
  "title": "Hypertrophy Programs"
}

​
Using Folders with Routines

When creating or updating routines, you can organize them into folders by specifying the folder_id parameter.

​
Example Workflow

// Create a new folder for your program
{
  "title": "Push/Pull/Legs"
}

// Response
{
  "id": 1,
  "title": "Push/Pull/Legs",
  ...
}

​
Organizing Your Routines

Here are some common folder organization patterns:
Organize routines by training split methodology:
  • Push/Pull/Legs: Push Day, Pull Day, Leg Day
  • Upper/Lower: Upper Body, Lower Body
  • Bro Split: Chest Day, Back Day, Leg Day, Shoulder Day, Arm Day
Organize routines by training objective:
  • Strength: Powerlifting routines, max strength programs
  • Hypertrophy: Bodybuilding splits, volume-focused training
  • Conditioning: HIIT workouts, cardio routines
Organize routines by specific training programs:
  • Starting Strength: Workout A, Workout B
  • nSuns 531: Day 1, Day 2, Day 3, Day 4
  • PHAT: Upper Power, Lower Power, Back/Shoulders, Legs, Chest/Arms
Organize routines by where or how you train:
  • Home Gym: Limited equipment routines
  • Commercial Gym: Full equipment routines
  • Travel Workouts: Bodyweight and minimal equipment

​
Routines Without Folders

Routines can exist without being in a folder. When creating a routine:
  • With folder: Set folder_id to a valid folder ID
  • Without folder: Set folder_id to null or omit it
Example: Routine without folder
{
  "title": "Quick Full Body",
  "folder_id": null,  // Or omit this field entirely
  "exercises": [...]
}
When fetching routines, those not in folders will have folder_id: null.

Build docs developers (and LLMs) love

Get started for freeTalk to us