Health & fitness
TrueCoach
Workouts, programs, compliance and client messages for your TrueCoach roster.
16 endpoints
Hevy's public API covers a Pro user's own workouts, not Hevy Coach clients, and there is no Hevy Coach MCP server (checked 14 Nov 2026). Cotlet runs a hosted Hevy Coach MCP server with 13 tools that ChatGPT and Claude use in your own coach account. Invites, programs and chat messages wait for your OK.
13 tools Read and write
Hevy publishes a public API for Hevy Pro users with an API key from hevy.com/settings. It covers that user's own workouts, routines, routine folders, exercise templates and body measurements. It has no endpoints for Hevy Coach clients, coach programs, chat or teams, and no Hevy Coach MCP server or official ChatGPT or Claude connector was verified.
| What you need | Hevy API | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No MCP server | Copy and paste | Hosted MCP server |
| Your clients, invites and chat | Not in the API | In Hevy Coach | Writes after your OK |
| Programs and exercises | Your own routines only | In the Program Library | Build and assign to clients |
| Run from n8n or a script | One Pro account, your code | Manual only | REST, same key |
Checked 14 Nov 2026. Sources: Hevy Coach · Hevy public API documentation · Hevy Coach Help Center · Help: Dashboard · Help: Clients · Help: Invite clients · Help: Delete access to your clients · Help: Program Library · Help: Create a program · Help: Assign a program · Help: Exercise Library · Help: Create a custom exercise · Help: Chat · Help: Progress pictures · Help: Create your team · Help: Public invite link
Once, in a browser we host for you.
One address in its settings.
See who went quiet, then approve each message.
Your agent works in your own signed-in Cloud Browser. Invites, program copies and chat messages wait for your OK. Who can see your session
Sign in to Hevy Coach in a Cloud Browser. Open app.hevycoach.com in your Cotlet Cloud Browser and log in with your own coach account.
Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.
Hevy Coach is reached through the shared address https://cotlet.dev/mcp/v1, the same one every other enabled app uses, so one connector is enough. Enabled Hevy Coach later? Refresh the connector for its 13 tools.
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect
Claude Code:
claude mcp add --transport http cotlet \
https://cotlet.dev/mcp/v1 \
--header "Authorization: Bearer $COTLET_API_KEY" // ~/.cursor/mcp.json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
}
}
} # ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY" MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: hevy_coach_read One tool per coach workflow in the Hevy Coach Help Center. The dashboard, client list, libraries and progress pictures only read; everything that reaches a client, a lead or a teammate asks first.
Who trained last week, who has not accepted an invite, and their progress pictures.
The same overview as the Dashboard: clients active and inactive over the last week, and a feed of their latest activities, such as logged workouts and progress pictures. Read only.
MCP callhevy_coach_read → view_dashboard
REST endpointGET https://cotlet.dev/api/v1/hevy-coach/dashboards/view
No parameters.
{
"active_last_week": [
"Jordan Example",
"Sam Sample"
],
"inactive_last_week": [
"Taylor Demo"
],
"latest": [
{
"client": "Jordan Example",
"activity": "Logged Upper A",
"date": "2026-11-13"
}
]
} Returns the Clients screen: every client with their status, so you can see who has not accepted an invite yet. On a team, an admin sees every client of the team and a member sees their own. Read only.
MCP callhevy_coach_read → list_clients
REST endpointGET https://cotlet.dev/api/v1/hevy-coach/clients
No parameters.
{
"clients": [
{
"client": "Jordan Example",
"status": "Active",
"program": "Upper Lower"
},
{
"client": "Riley Sample",
"status": "Invited",
"program": null
}
]
} Clients log a picture with a measurement in the Hevy app; this reads the Progress Pictures section of their profile, with each picture's date and image link. Read only.
MCP callhevy_coach_read → view_progress_pictures
REST endpointGET https://cotlet.dev/api/v1/hevy-coach/progress-pictures/view
| Name | Type | Description |
|---|---|---|
| client string required | string | Client name or email, as on the Clients screen. |
| from string | string | ISO date of the earliest picture to include. |
{
"client": "client"
} {
"client": "Jordan Example",
"pictures": [
{
"date": "2026-09-01",
"url": "https://example.com/p/0901.jpg"
},
{
"date": "2026-11-03",
"url": "https://example.com/p/1103.jpg"
}
]
} The client gets an email (it can land in spam) and becomes your client once they accept. Anyone who accepts your coach link becomes a client with no step on your side, so the agent only reads the link and leaves sharing it to you. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → invite_client
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/client/invite
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `invite`, `resend`, `coach_link`. `list` only reads. |
| email string | string | Client email, for `invite` and `resend`. |
| hevy_username string | string | Or their Hevy app username: they also get a notification in the Hevy app. |
{
"action": "action"
} {
"email": "riley@example.com",
"status": "Invited",
"sent": true
} The client loses the coach tab in Hevy and your programs with it. They keep their workout history on a free Hevy account, which allows up to four routines. Re-adding them needs a new invite. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → remove_client
REST endpointDELETE https://cotlet.dev/api/v1/hevy-coach/clients
| Name | Type | Description |
|---|---|---|
| client string required | string | Client name or email, as on the Clients screen. |
{
"client": "client"
} {
"client": "Taylor Demo",
"removed": true
} Build programs from routines, add your own exercises, and copy a program to clients.
The Program Library holds your workout programs, each made of routines, sorted into folders. On a team it also shows the shared team library. Read only.
MCP callhevy_coach_read → view_program_library
REST endpointGET https://cotlet.dev/api/v1/hevy-coach/program-libraries/view
| Name | Type | Description |
|---|---|---|
| folder string | string | Folder name. Leave empty for all. |
{
"folders": [
{
"folder": "Strength",
"programs": [
{
"program": "Upper Lower",
"routines": [
"Upper A",
"Lower A",
"Upper B",
"Lower B"
]
},
{
"program": "Push Pull Legs",
"routines": [
"Push",
"Pull",
"Legs"
]
}
]
}
]
} Includes your own custom exercises. Use it to pick exercises before create_program. Read only.
MCP callhevy_coach_read → browse_exercise_library
REST endpointGET https://cotlet.dev/api/v1/hevy-coach/exercise-libraries/browse
| Name | Type | Description |
|---|---|---|
| equipment string | string | For example Dumbbell or Barbell. |
| muscle string | string | For example Biceps. |
| exercise string | string | An exercise name, to read its details and instructions. |
{
"equipment": "Dumbbell",
"muscle": "Biceps",
"exercises": [
"Bicep Curl (Dumbbell)",
"Hammer Curl (Dumbbell)",
"Concentration Curl"
]
} Saves to the Program Library only. No client sees it until you assign it with assign_program. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → create_program
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/programs
| Name | Type | Description |
|---|---|---|
| name string required | string | Program name. |
| folder string | string | Folder in the Program Library; created if new. |
| routines array required | array | Routines, each new or an earlier one, with exercises and their sets and reps. |
{
"name": "Jane Doe",
"routines": "routines"
} {
"program": "Upper Lower",
"folder": "Strength",
"routines": 4,
"saved": true
} The exercise joins your Exercise Library and can go into any routine. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → create_custom_exercise
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/custom-exercises
| Name | Type | Description |
|---|---|---|
| name string required | string | Exercise name. |
| exercise_type string | string | Exercise type, as Hevy Coach lists them. |
| equipment string | string | Equipment. |
| primary_muscle string | string | Primary muscle group. |
| other_muscles array | array | Other muscles. |
| instructions string | string | Exercise instructions. |
| image_url string | string | Image the Cloud Browser can download. |
| video_url string | string | Video to attach. |
{
"name": "Jane Doe"
} {
"exercise": "Tempo Goblet Squat",
"equipment": "Kettlebell",
"primary_muscle": "Quadriceps",
"saved": true
} Works like Copy Workout to Clients: each client gets their own copy in the coach tab of their Hevy app, so later edits to the template do not change it. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → assign_program
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/program/assign
| Name | Type | Description |
|---|---|---|
| program string required | string | Program from the Program Library. |
| clients array required | array | Clients who get a copy. |
{
"program": "Upper Lower",
"clients": [
"Riley Sample"
]
} {
"program": "Upper Lower",
"clients": [
"Riley Sample"
],
"copied": true
} The built-in chat, your coaching team, and leads from your public invite link.
Uses the built-in chat. A message reaches the client at once, so the agent shows you the text first. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → send_message
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/messages
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `send`. `list` only reads. |
| client string required | string | Client name or email, as on the Clients screen. |
| text string | string | The message, for `send`. |
{
"action": "action",
"client": "client"
} {
"client": "Taylor Demo",
"sent": true
} Teams come at no extra cost. Admins see every coach's clients, programs and stats and can reassign clients; members see their own. Only an admin login can reassign. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → manage_team
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/team/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `create`, `invite_member`, `set_role`, `reassign_client`. `list` only reads. |
| name string | string | Team name, for `create`. |
| member string | string | Coach email or name. |
| role string | string | `admin` or `member`. |
| client string | string | For `reassign_client`. |
{
"action": "action"
} {
"team": "Example Strength Team",
"members": [
{
"coach": "Alex",
"role": "admin",
"clients": 18
},
{
"coach": "Sam",
"role": "member",
"clients": 11
}
]
} From the Grow section. Each lead left a name, email and message. Accepting sends them a link to download the Hevy app and be coached by you. By default you confirm each call; you can switch that off for this tool.
MCP callhevy_coach_write → manage_public_invite
REST endpointPOST https://cotlet.dev/api/v1/hevy-coach/public-invite/manage
| Name | Type | Description |
|---|---|---|
| action string required | string | One of `list`, `accept`, `customize`. `list` only reads. |
| lead string | string | Lead name or email, for `accept`. |
| form_text string | string | For `customize`: the text on your contact form. |
{
"action": "action"
} {
"leads": [
{
"name": "Chris Example",
"email": "chris@example.com",
"message": "Looking for a 3-day strength plan."
}
]
} Your signed-in Hevy Coach browser profile, AES-256-GCM encrypted, in Finland. Never your password.
The 13 Hevy Coach tools. The session cookie stays in the Cloud Browser.
The clients, programs and chats of the coach who signs in; on a team, what that coach's role allows.
Your Hevy Coach account, subscription and notification settings, and your clients' own Hevy accounts.
You log in again yourself, in the same Cloud Browser.
Disable Hevy Coach for agents, reset the browser, or change your Hevy Coach password.
Cotlet never sees or stores your password: you log in to Hevy Coach yourself and the agent works only in that session. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).
Cotlet watches the apps it serves and updates the Hevy Coach server when the coach web app changes, so your agent keeps working without a change on your side.
New Hevy Coach features become available to the agent. It still sees only what the signed-in coach sees: a team member login reaches its own clients, an admin login the whole team.
If Hevy Coach signs you out, one click in the Cotlet console reopens the Cloud Browser so you can log in again.
| Action | How to put it right |
|---|---|
| Program copied to the wrong client | Edit or replace their copy in Hevy Coach; the template stays as it was |
| Client reassigned on the team | Reassign them back with manage_team |
| Client removed | Invite them again; their workout history stays with them |
| Chat message or invite | Already with the client: follow up in chat |
All 8 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 5 read tools run at once.
{
"name": "assign_program",
"arguments": {
"program": "Upper Lower",
"clients": [
"Riley Sample"
]
}
} curl -X POST https://cotlet.dev/api/v1/hevy-coach/program/assign \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"program":"Upper Lower","clients":["Riley Sample"]}' {
"program": "Upper Lower",
"clients": [
"Riley Sample"
],
"copied": true
} The example copies the Upper Lower program to Riley Sample. A cron job or n8n flow can make the same call over REST at /api/v1/hevy-coach with the same key and price, in JSON. Failed calls are free.
About $17 a monthfor a coach with 25 clients, 2,900 credits. Your Hevy Coach plan stays as it is.
| Job | Calls | Credits |
|---|---|---|
| Monday dashboard and notes to quiet clients | 5 × 4 | 200 |
| Client chat replies | 1 × 60 | 600 |
| Progress picture reviews | 1 × 25 | 250 |
| New clients invited and programs assigned | 3 × 5 | 150 |
| New programs built from the library | 6 × 2 | 120 |
| Public invite link leads | 2 × 4 | 80 |
| Cloud Browser, 30 days | 1,500 | |
| Total | 140 calls | 2,900 |
The smallest pack, 5,000 credits for $29, covers this month with room left. Daily chat through the agent uses more calls.
Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.
| Credits | Price, one time | Calls at 10 credits | Per 1,000 credits |
|---|---|---|---|
| 5,000 | $29 | 500 | $5.80 |
| 15,000 | $79 | 1,500 | $5.27 |
| 32,000 | $149 | 3,200 | $4.66 |
| 60,000 | $249 | 6,000 | $4.15 |
Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.
| Option | What it does | Where it stops |
|---|---|---|
| Hevy public API | Reads and writes one Hevy Pro user's own workouts and routines. | No clients, coach programs, chat or teams. |
| Hevy Coach web app | Every coach screen: dashboard, clients, libraries, chat. | One client at a time, only while you are at it. |
| Hevy Coach teams | More coaches sharing clients and a program library, at no extra cost. | More people doing the work by hand. |
If Hevy adds coaching to its API and it covers your job, use it: it would be the vendor's own route. Cotlet fits when you want ChatGPT, Claude or a script working in Hevy Coach today, from your own coach login, with nothing to host.
Cotlet is a product of Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and trading since 2019. It is led by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Hevy Coach tools: contact@cotlet.dev.
Sign up free at https://cotlet.dev/signup?app=hevy-coach, turn on Hevy Coach under Integrations in the console and log in at https://app.hevycoach.com/ in your Cloud Browser. Then connect your AI agent and ask it about your clients. The trial needs no card.
Hevy Coach publishes no API for coaching work (checked 14 Nov 2026). Hevy's public API, for Hevy Pro users, reads and writes the user's own workouts, routines, exercise templates and body measurements, with no clients, coach programs or chat. No Hevy Coach MCP server and no official ChatGPT or Claude connector was verified. Cotlet does not use that API: it works in your own signed-in Hevy Coach account.
Per the Hevy Coach Help Center, they lose the coach tab and your programs, keep their workout history and continue on a free Hevy account with up to four routines. remove_client asks before it runs.
Yes. Sign in with the coach whose work the agent should do. An admin login sees every client and program on the team and can reassign clients; a member login sees its own clients.
No. Clients log their workouts and progress pictures in the Hevy app. The agent works on the coach side and reads what they logged.
Only in how it is called. Both carry the same 13 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.
No. Cotlet is independent and not affiliated with Hevy or Hevy Coach.
Free 7-day trial with 2,000 credits, no card needed.
May we use Google Analytics to see which pages help people? It sets cookies only if you accept. No ads, and we never sell data. Cookie policy