Hevy Coach MCP Server

Clients, workout programs, exercises, chat and teams in Hevy Coach.

Hosted MCP Server

npx add-mcp 'https://cotlet.dev/mcp/v1/hevy-coach'

Installs into Claude Code, Codex, Cursor and more

Documentation

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Hevy Coach API and MCP server: Let your AI agent keep every Hevy client on program.

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.

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.

What can your AI agent do in Hevy Coach?

  • Find clients who went quiet last week
  • Invite a client and copy them a program
  • Build a program from the exercise library
  • Line up progress pictures before a check-in
  • Draft check-in messages in chat
  • Work leads from your public invite link

Does Hevy Coach have an MCP server or an API?

  • Hevy's API documentation is at api.hevyapp.com/docs, version 0.0.1, for Hevy Pro users only.
  • Hevy Coach clients train in the Hevy app; programs you assign show in their coach tab.
  • Teams in Hevy Coach come at no extra cost, with admin and member roles.
What you needHevy APIBy handCotlet
Ask ChatGPT or Claude to do the workNo MCP serverCopy and pasteHosted MCP server
Your clients, invites and chatNot in the APIIn Hevy CoachWrites after your OK
Programs and exercisesYour own routines onlyIn the Program LibraryBuild and assign to clients
Run from n8n or a scriptOne Pro account, your codeManual onlyREST, 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

How does the Hevy Coach MCP server work?

  1. Sign in to Hevy Coach. Once, in a browser we host for you.
  2. Connect your AI agent. One address in its settings.
  3. Ask on Monday. 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.

How to connect Hevy Coach to your AI agent

  1. 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.
  2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
  3. 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.

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Claude:

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:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: hevy_coach_read

All 13 Hevy Coach MCP tools

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.

Clients and progress

Who trained last week, who has not accepted an invite, and their progress pictures.

  • View the coaching dashboard (view_dashboard, read): Read who was active or inactive in the last week and your clients' latest activities.
  • View the client list (list_clients, read): Read your clients and the status of each invitation.
  • Review progress pictures (view_progress_pictures, read): List a client's progress pictures by date, to compare two of them.
  • Invite clients (invite_client, write, asks first): Invite a client by email or Hevy username, resend an invite, or read your coach link.
  • Remove client access (remove_client, write, asks first): Delete a client from your client list.

Programs and exercises

Build programs from routines, add your own exercises, and copy a program to clients.

  • View the program library (view_program_library, read): Read your programs, their folders and the routines in each.
  • Browse the exercise library (browse_exercise_library, read): Search exercises by equipment and muscle and read an exercise's instructions.
  • Create workout programs (create_program, write, asks first): Create a program of routines, with exercises, sets and reps, in a folder.
  • Create custom exercises (create_custom_exercise, write, asks first): Add your own exercise with type, equipment, muscles, instructions, image and video.
  • Assign programs to clients (assign_program, write, asks first): Copy a program from your library to one or more clients.

Chat, team and leads

The built-in chat, your coaching team, and leads from your public invite link.

  • Message clients (send_message, write, asks first): Read a client chat or send a client a message.
  • Manage your coaching team (manage_team, write, asks first): Read your team, invite a coach, set their access, or reassign a client to another coach.
  • Manage public invite link leads (manage_public_invite, write, asks first): Read the leads from your public invite link, accept one, or change the contact form text.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/hevy-coach-api-mcp-server#tools

Who can see my Hevy Coach session, and how do I revoke it?

  • What we store. Your signed-in Hevy Coach browser profile, AES-256-GCM encrypted, in Finland. Never your password.
  • What your agent gets. The 13 Hevy Coach tools. The session cookie stays in the Cloud Browser.
  • What the session sees. The clients, programs and chats of the coach who signs in; on a team, what that coach's role allows.
  • What no tool touches. Your Hevy Coach account, subscription and notification settings, and your clients' own Hevy accounts.
  • If Hevy Coach signs you out. You log in again yourself, in the same Cloud Browser.
  • How to cut access. 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).

What happens when Hevy Coach changes?

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.

Approvals, undo and mistakes

  1. Invite the client. invite_client emails riley@example.com.
  2. Wait for the accept. list_clients shows the status.
  3. Show you the program. Upper Lower, four routines.
  4. Copy after your OK. assign_program puts it in their coach tab.
ActionHow to put it right
Program copied to the wrong clientEdit or replace their copy in Hevy Coach; the template stays as it was
Client reassigned on the teamReassign them back with manage_team
Client removedInvite them again; their workout history stays with them
Chat message or inviteAlready 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.

MCP call:

{
  "name": "assign_program",
  "arguments": {
    "program": "Upper Lower",
    "clients": [
      "Riley Sample"
    ]
  }
}

REST:

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"]}'

Response:

{
  "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.

How much does the Hevy Coach MCP server cost?

About $17 a month for a coach with 25 clients, 2,900 credits. Your Hevy Coach plan stays as it is.

JobCallsCredits
Monday dashboard and notes to quiet clients5 × 4200
Client chat replies1 × 60600
Progress picture reviews1 × 25250
New clients invited and programs assigned3 × 5150
New programs built from the library6 × 2120
Public invite link leads2 × 480
Cloud Browser, 30 days1,500
Total140 calls2,900

The smallest pack, 5,000 credits for $29, covers this month with room left. Daily chat through the agent uses more calls.

  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Your Hevy Coach plan applies as it is

Credit packs are one-time purchases, not a subscription. The month above is an example built from our own assumptions, not measured customer usage.

Hevy Coach MCP server: other ways to connect

OptionWhat it doesWhere it stops
Hevy public APIReads and writes one Hevy Pro user's own workouts and routines.No clients, coach programs, chat or teams.
Hevy Coach web appEvery coach screen: dashboard, clients, libraries, chat.One client at a time, only while you are at it.
Hevy Coach teamsMore 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.

Who runs Cotlet

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.

Hevy Coach MCP server: questions

How do I get access?

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.

Does Hevy Coach have an API?

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.

What happens to a client I remove?

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.

Does it work for a team of coaches?

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.

Can the agent log workouts for my 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.

Is the MCP server different from the REST API?

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.

Is Cotlet affiliated with Hevy Coach?

No. Cotlet is independent and not affiliated with Hevy or Hevy Coach.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.