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

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.

  • Free 7-day trial, no card
  • Unofficial, not affiliated with Hevy Coach
Hevy Coach logo Hevy Coach Cloud Browser

13 tools Read and write

Online coaching

What can your AI agent do in Hevy Coach? The coaching admin around your clients' Hevy workouts.

  • 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

Hevy API only, no coach API

Does Hevy Coach have an MCP server or an API? The official Hevy and Hevy Coach routes, checked 14 November 2026.

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 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.
The Hevy API, working by hand and Cotlet compared
What you need Hevy APIBy handCotlet
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

Set up once

How does the Hevy Coach MCP server work? The Hevy Coach MCP server by Cotlet: your agent works in your own Hevy Coach account.

  1. 1Sign in to Hevy Coach

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Ask 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. Who can see your session

Any MCP client

How to connect Hevy Coach to your AI agent

  1. 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. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 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
5 read, 8 write

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 progress5

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

  • view_dashboard Read who was active or inactive in the last week and your clients' latest activities. read

    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

    Parameters

    No parameters.

    Example response

    {
      "active_last_week": [
        "Jordan Example",
        "Sam Sample"
      ],
      "inactive_last_week": [
        "Taylor Demo"
      ],
      "latest": [
        {
          "client": "Jordan Example",
          "activity": "Logged Upper A",
          "date": "2026-11-13"
        }
      ]
    }
  • list_clients Read your clients and the status of each invitation. read

    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

    Parameters

    No parameters.

    Example response

    {
      "clients": [
        {
          "client": "Jordan Example",
          "status": "Active",
          "program": "Upper Lower"
        },
        {
          "client": "Riley Sample",
          "status": "Invited",
          "program": null
        }
      ]
    }
  • view_progress_pictures List a client's progress pictures by date, to compare two of them. read

    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

    Parameters

    Parameters: view_progress_pictures
    NameTypeDescription
    client string required string Client name or email, as on the Clients screen.
    from string string ISO date of the earliest picture to include.

    Example input

    {
      "client": "client"
    }

    Example response

    {
      "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"
        }
      ]
    }
  • invite_client Invite a client by email or Hevy username, resend an invite, or read your coach link. writeAsks first

    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

    Parameters

    Parameters: invite_client
    NameTypeDescription
    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.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "email": "riley@example.com",
      "status": "Invited",
      "sent": true
    }
  • remove_client Delete a client from your client list. writeAsks first

    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

    Parameters

    Parameters: remove_client
    NameTypeDescription
    client string required string Client name or email, as on the Clients screen.

    Example input

    {
      "client": "client"
    }

    Example response

    {
      "client": "Taylor Demo",
      "removed": true
    }

Programs and exercises5

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

  • view_program_library Read your programs, their folders and the routines in each. read

    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

    Parameters

    Parameters: view_program_library
    NameTypeDescription
    folder string string Folder name. Leave empty for all.

    Example response

    {
      "folders": [
        {
          "folder": "Strength",
          "programs": [
            {
              "program": "Upper Lower",
              "routines": [
                "Upper A",
                "Lower A",
                "Upper B",
                "Lower B"
              ]
            },
            {
              "program": "Push Pull Legs",
              "routines": [
                "Push",
                "Pull",
                "Legs"
              ]
            }
          ]
        }
      ]
    }
  • browse_exercise_library Search exercises by equipment and muscle and read an exercise's instructions. read

    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

    Parameters

    Parameters: browse_exercise_library
    NameTypeDescription
    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.

    Example response

    {
      "equipment": "Dumbbell",
      "muscle": "Biceps",
      "exercises": [
        "Bicep Curl (Dumbbell)",
        "Hammer Curl (Dumbbell)",
        "Concentration Curl"
      ]
    }
  • create_program Create a program of routines, with exercises, sets and reps, in a folder. writeAsks first

    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

    Parameters

    Parameters: create_program
    NameTypeDescription
    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.

    Example input

    {
      "name": "Jane Doe",
      "routines": "routines"
    }

    Example response

    {
      "program": "Upper Lower",
      "folder": "Strength",
      "routines": 4,
      "saved": true
    }
  • create_custom_exercise Add your own exercise with type, equipment, muscles, instructions, image and video. writeAsks first

    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

    Parameters

    Parameters: create_custom_exercise
    NameTypeDescription
    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.

    Example input

    {
      "name": "Jane Doe"
    }

    Example response

    {
      "exercise": "Tempo Goblet Squat",
      "equipment": "Kettlebell",
      "primary_muscle": "Quadriceps",
      "saved": true
    }
  • assign_program Copy a program from your library to one or more clients. writeAsks first

    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

    Parameters

    Parameters: assign_program
    NameTypeDescription
    program string required string Program from the Program Library.
    clients array required array Clients who get a copy.

    Example input

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

    Example response

    {
      "program": "Upper Lower",
      "clients": [
        "Riley Sample"
      ],
      "copied": true
    }

Chat, team and leads3

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

  • send_message Read a client chat or send a client a message. writeAsks first

    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

    Parameters

    Parameters: send_message
    NameTypeDescription
    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`.

    Example input

    {
      "action": "action",
      "client": "client"
    }

    Example response

    {
      "client": "Taylor Demo",
      "sent": true
    }
  • manage_team Read your team, invite a coach, set their access, or reassign a client to another coach. writeAsks first

    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

    Parameters

    Parameters: manage_team
    NameTypeDescription
    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`.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "team": "Example Strength Team",
      "members": [
        {
          "coach": "Alex",
          "role": "admin",
          "clients": 18
        },
        {
          "coach": "Sam",
          "role": "member",
          "clients": 11
        }
      ]
    }
  • manage_public_invite Read the leads from your public invite link, accept one, or change the contact form text. writeAsks first

    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

    Parameters

    Parameters: manage_public_invite
    NameTypeDescription
    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.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "leads": [
        {
          "name": "Chris Example",
          "email": "chris@example.com",
          "message": "Looking for a 3-day strength plan."
        }
      ]
    }
Encrypted, revocable

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).

We keep it working

What happens when Hevy Coach changes? The tools use the same coach web app you work in.

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.

8 tools ask first

Approvals, undo and mistakes Clients and leads hear nothing until you say so.

  1. 01 Invite the client invite_client emails riley@example.com.
  2. 02 Wait for the accept list_clients shows the status.
  3. 03 Show you the program Upper Lower, four routines.
  4. 04 Copy after your OK assign_program puts it in their coach tab.
Fixing a Hevy Coach write that went wrong
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.

Pay per call

How much does the Hevy Coach MCP server cost?

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

Illustrative month, our assumption: successful calls for this workload
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.

Cotlet credit packs: price, credits and calls at 10 credits each
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.

Other options

Hevy Coach MCP server: other ways to connect What each route does for a coach, and where it stops.

Other ways to work with Hevy Coach, checked 14 Nov 2026
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.

EU company, since 2019

Who runs Cotlet A company you can look up.

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.

Let your agent find the clients who went quiet in Hevy Coach.

Free 7-day trial with 2,000 credits, no card needed.