TrueCoach MCP Server

Workouts, programs, compliance and client messages for your TrueCoach roster.

Hosted MCP Server

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

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

TrueCoach API and MCP server: Let your AI agent write your TrueCoach week.

TrueCoach has no official MCP server, no public API and no developer docs (checked 24 Oct 2026). The one key it hands out is for Zapier. Cotlet runs 16 TrueCoach tools hosted, over MCP for agents and REST for scripts.

Read TrueCoach client compliance, workouts and metrics through MCP or REST. Connect an AI agent, n8n, Make or a script to your coaching account.

MCP setup REST API guide

Free 7-day trial, no card
Unofficial, not affiliated with TrueCoach or Xplor
Page: https://cotlet.dev/integrations/truecoach-api-mcp-server

What can you automate in TrueCoach?

Write workouts from your notes
Assign a program to a group
Check in on clients who missed sessions
Group clients and message them
Report compliance and due dates
Track lifts and body metrics

Does TrueCoach have an MCP server or an API?

Zapier works on Pro ($164.98 a month) and above, per the TrueCoach help center: 4 triggers (new client, client added to a group, workout created, workout completed) and 1 action, add a client. Zapier MCP has the same one action.
No webhooks of its own, no Make app and no n8n node.
GitHub has no TrueCoach MCP server, only export scripts and two unofficial Go clients that call the private web API with your login.

What you need	TrueCoach + Zapier (Pro)	GitHub script	Cotlet
Add a client	Yes	Some	No, add them in TrueCoach
Write workouts on a client calendar	No	Some	Yes, after your OK
Assign and unassign programs	No	No	Yes, groups too, after your OK
Compliance, results and messages	Completed workouts only	Read only	Read and send
Works on Starter or Standard	Pro only	Yes	Yes
Fixed for you when TrueCoach changes	Yes	No	Yes, tested every 12 h

Checked 24 Oct 2026. Sources: TrueCoach Help: Zapier Integration, TrueCoach pricing, Zapier MCP for TrueCoach, TrueCoach Terms of Service (Xplor)

How does Cotlet connect to TrueCoach?

Sign in to TrueCoach. Use your own account in its Cotlet Cloud Browser.
Choose MCP or REST. Connect your agent or create a Cotlet API key.
Run your workflow. Ask your agent or send an HTTP request.

We never save your TrueCoach password, and workouts, programs and messages wait for your OK before they go out.

Connect TrueCoach to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

Enable TrueCoach. Sign up, log in to your TrueCoach coach account in its Cloud Browser and turn it on for agents.
Paste the address. Add https://cotlet.dev/mcp/v1/truecoach as an MCP server or connector in your agent.
Sign in or use a key. Chat apps sign you in to Cotlet; editors and scripts take an API key from the console.

https://cotlet.dev/mcp/v1 also works and covers every app you enable. Turned TrueCoach on after connecting? Refresh the connector so the tools show up.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-truecoach \
  https://cotlet.dev/mcp/v1/truecoach \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

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

Cursor:

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

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-truecoach]
url = "https://cotlet.dev/mcp/v1/truecoach"
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: truecoach_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: truecoach_write

How to use the TrueCoach REST API

Create your Cotlet API key

Sign in to your TrueCoach coach account in its Cotlet Cloud Browser and enable the app for agents. A client login does not grant coach access.

Create a Cotlet API key with access to TrueCoach and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Make your first TrueCoach API request

cURL: list_clients:

curl "https://cotlet.dev/api/v1/truecoach/clients?limit=10" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read clients and follow every page

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "truecoach",
  "tool": "list_clients",
  "result": {
    "clients": [
      {
        "client_id": "3600241",
        "name": "Alex Rivera",
        "compliance_7_days": 85.7,
        "demo": false
      }
    ],
    "total": 1,
    "next_cursor": null
  }
}

Read result.clients and pass result.next_cursor unchanged as cursor until null. Keep filters and limit unchanged; a short page alone is not the stopping rule.

The default page has 50 clients, with a maximum of 100. Compare compliance values by client_id when refreshing reports.

For list_workouts, provide a client ID and date range of at most 366 days. That read has no cursor and caps returned workouts at 1,000; keep reporting ranges narrow.

TrueCoach workflows for agents and automations

Tool	Connect through	Example workflow
Python or Node.js	REST API	Page through `list_clients` and refresh a daily compliance sheet by client ID and changing compliance values.
n8n	HTTP Request	Read clients and their workouts for a chosen week, then prepare a missed-workout digest in your chosen destination.
Make	HTTP > Make a request	Combine clients and `list_metrics` into a progress report that retains measurement dates, units and targets.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads TrueCoach; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

TrueCoach API endpoints and MCP tools

Clients, groups and the dashboard

Remote, Dual and In-Person clients with their 7, 30 and 90 day compliance. In-Person clients get no invitation and no login.

List clients (list_clients, read): Your clients with client type, groups, 7, 30 and 90 day compliance rates and due date.
Get client (get_client, read): One client: profile, client type, groups, compliance rates, due date and assigned programs.
Get dashboard (get_dashboard, read): Your overall compliance rate, clients under Needs Attention, clients due soon and today's workouts.
Add client to group (add_client_to_group, write): Add a client to one of your client groups. A client can be in several groups.

Workouts

Link an exercise from the library with its ID and the demo video comes along. A day can hold more than one workout.

List workouts (list_workouts, read): Workouts on a client's workout calendar in a date range, with status.
Get workout (get_workout, read): Full workout: title, warmup, exercises and circuits, cooldown, and the results the client logged.
Create workout (create_workout, write, asks first): Write a workout on a client's workout calendar for a given day.
Search exercises (search_exercises, read): Find exercises by name in the TrueCoach library and your own, with video link and tags.
Create exercise (create_exercise, write): Add your own exercise with a demo video to your TrueCoach exercise library.

Programs

Start on any program day. Your later edits reach clients only with Sync on, and TrueCoach locks Sync while a program is assigned.

List programs (list_programs, read): Programs in your account with tags and the clients they are assigned to.
Assign program (assign_program, write, asks first): Put a program on the workout calendars of clients or client groups.
Unassign program (unassign_program, write, asks first): Remove a program from a client's calendar. Completed and missed workouts stay.

Metrics and messages

A metric has to be assigned to the client first. On a Team Account you can message only your own clients, admin or not.

List metrics (list_metrics, read): A client's metrics (for example back squat or body fat %) with their values over time.
Update metric (update_metric, write): Record a new value for one of a client's metrics.
List messages (list_messages, read): Recent messages in your conversation with a client, newest first.
Send message (send_message, write, asks first): Message a client or every client in a group, as you.

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

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

What we store. Your logged-in TrueCoach profile, AES-256-GCM, in Finland. Not your password.
What your agent gets. TrueCoach tools only, never the login or a cookie.
What the session sees. What your coach login sees: clients, their results and metrics, your conversations.
What no tool touches. TrueCoach Payments, your plan, team settings and your password.
If TrueCoach logs you out. An email tells you, with a link to log in again. We never do it for you.
How to cut access. Disable for agents, reset the browser or delete the key. The next call stops.

A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results). No SOC 2 report or third-party pentest yet.

Is it against TrueCoach's terms? Account safety

Use any robot, spider, crawler, scraper, or other manual or automated means or interface to access the Services, retrieve, index, scrape, "data mine" or otherwise gather Content or extract other user's information.

TrueCoach Terms of Service (Xplor), Feb 2026

The next clause asks for written consent before any third-party app interacts with the Services, and section I.5 lets Xplor suspend an account on notice. That covers every TrueCoach tool outside Zapier, the GitHub scripts included. We found no public case of a coach account closed for automation (checked 24 Oct 2026).

How we keep your account looking like you:

Your own coach account, logged in by you
One Cloud Browser with its own IP and cookies
Workouts, programs and messages wait for your OK
You finish sign-in and 2FA yourself
Should TrueCoach object, we pause it for every user within 24 h

TrueCoach's terms also name spam. For one note to a whole group, send it to the group once instead of 20 single messages in a row.

What happens when TrueCoach changes?

12 h between tests of every TrueCoach tool
24 h between tests of writes a client would see
29/29 checks passed on Nov 6, 2026
$0 for calls to a tool paused for a fix

TrueCoach is an Xplor brand now: its terms moved to xplor.com in February 2026, and its own pages disagree on whether Standard gets Zapier. A web app that keeps moving is why the tools are tested on a schedule. status.cotlet.dev checks the site, console and API every 3 minutes.

Approvals, undo and mistakes

Finds the client. By name, and asks when two clients share it.
Looks at the day. Asks before adding a second workout to it.
Writes the session. Your sets, tempo and cues, in builder fields.
Reports back. Workout ID, the new due date, moves with no video.

Action	Undo
Send a message	No; offline clients get the text by email too
Write a workout	Yes, edit or delete it in TrueCoach
Record a metric value	Yes, edit it in the Metric Manager
Assign a program	Yes, unassign_program; done workouts stay

4 of 16 tools ask first: writing a workout, assigning or unassigning a program and sending a message, the ones a client sees. Groups, metrics and exercises go straight through, since you can change each one in TrueCoach. You can switch the wait off per tool, or enable TrueCoach read only.

Reads never ask: clients, workouts, results, metrics, chats
A workout for today can trigger TrueCoach's daily workout email
A message to a group lands in each client's own chat with you

MCP call:

{
  "name": "create_workout",
  "arguments": {
    "client_id": "3600241",
    "date": "2026-11-04",
    "title": "Lower Body Strength",
    "warmup": "5 min bike\n2 rounds: 10 air squats",
    "items": [
      {
        "name": "Tempo Goblet Squat",
        "description": "4x8, 3 s down",
        "exercise_id": "21499699"
      },
      {
        "name": "Finisher",
        "description": "3 rounds: 10 lunges, 30 s plank",
        "is_circuit": true
      }
    ],
    "cooldown": "Stretch hips 5 min"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/truecoach/clients/3600241/workouts \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-11-04","title":"Lower Body Strength","warmup":"5 min bike\n2 rounds: 10 air squats","items":[{"name":"Tempo Goblet Squat","description":"4x8, 3 s down","exercise_id":"21499699"},{"name":"Finisher","description":"3 rounds: 10 lunges, 30 s plank","is_circuit":true}],"cooldown":"Stretch hips 5 min"}'

Tool output:

{
  "workout_id": "623784610",
  "date": "2026-11-04",
  "title": "Lower Body Strength",
  "status": "upcoming",
  "rest_day": false,
  "program_name": null,
  "exercise_count": 2,
  "client_id": "3600241",
  "warmup": "5 min bike\n2 rounds: 10 air squats",
  "items": [
    {
      "name": "Tempo Goblet Squat",
      "description": "4x8, 3 s down",
      "result": null,
      "status": "upcoming",
      "is_circuit": false,
      "exercise_id": "21499699"
    },
    {
      "name": "Finisher",
      "description": "3 rounds: 10 lunges, 30 s plank",
      "result": null,
      "status": "upcoming",
      "is_circuit": true,
      "exercise_id": null
    }
  ],
  "cooldown": "Stretch hips 5 min",
  "rest_day_instructions": null,
  "comments": []
}

REST under /api/v1/truecoach has the same tools for scripts and cron jobs. A call TrueCoach refuses, like a group that does not exist or a metric not assigned to the client, fails and costs no credits. The tools table lists the REST path of each tool.

How much does the TrueCoach MCP server cost?

About $25 a month for a coach with 20 active clients, 4,310 credits. TrueCoach bills your plan as before.

Job	Calls	Credits
Check in on clients who missed workouts, weekly	31 × 4	1,240
Write custom sessions from your notes, weekly	25 × 4	1,000
Next block for clients due soon, weekly	7 × 4	280
Report compliance and due dates, weekly	2 × 4	80
Lifts and body metrics report, monthly	21 × 1	210
Cloud Browser, 30 days		1,500
Total		4,310

Free 7-day trial, no card
10 credits per successful call, MCP or REST
50 credits a day for the Cloud Browser
No Pro plan or Zapier account needed

20 clients is the cap of TrueCoach's Standard plan, and TrueCoach's own totals (16,000+ coaches, 250,000+ clients) put the average near 16. The weekly check-in reads each client's calendar once, so it takes the most calls. Dollars at the $29 pack rate.

TrueCoach MCP server on GitHub, Zapier or hosted: which to use

Option	What it does	Where it stops
Zapier MCP for TrueCoach	Create Client as an MCP tool, plus 4 triggers for Zaps.	Pro plan only, per TrueCoach; nothing for workouts, programs, metrics or messages.
tobiassjosten/go-truecoach	Unofficial Go client for the private web API, MIT. A second one, seonixx/truecoach, was pushed 10 Aug 2026.	A library, not an MCP server; 1 star, last commit 29 May 2024.
mcummins/hevy-truecoach-sync	Two-way sync between Hevy and TrueCoach through Claude browser automation, Python.	One job, runs on your computer, no license; 0 stars, last push 29 Sep 2026.
Assistant Coach	Another coaching platform with a read-only ChatGPT and Claude connector.	You move your clients off TrueCoach, and it cannot message them.

Pick Zapier if you are on Pro and only need sign-ups from a form to land as clients. Pick a GitHub script for a one-off export of your own data. Pick Cotlet if your agent should write sessions, start programs and follow up with clients on any plan.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Cotlet is run by Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), working since 2019. The founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the TrueCoach tools go to contact@cotlet.dev.

TrueCoach API and MCP: questions

Can I use the TrueCoach API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.

How do I get access?

Sign up free at https://cotlet.dev, open TrueCoach under Integrations in the console and log in to your TrueCoach coach account in its Cloud Browser. Your free trial starts when you sign up, no card needed.

How do I connect TrueCoach to ChatGPT or Claude?

Sign up at cotlet.dev, log in to TrueCoach once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your TrueCoach account through Cotlet, in their phone apps too.

What can ChatGPT do in TrueCoach?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in TrueCoach: check in with clients who missed workouts; write a client; start a program for a client group. You ask in plain words, and anything that reaches other people waits for your OK first.

Which TrueCoach plan and role do I need?

Cotlet acts as the signed-in coach and sees what that coach sees. We build and test on a coach account that owns its organization, on the 14-day trial. We have not tried a Team Account coach without admin rights, so private programs and clients of other coaches may not show there.

How do I sign in to TrueCoach?

In your own Cloud Browser, on app.truecoach.co, with your email and password. TrueCoach asks for no code by text or email at sign-in. Cotlet keeps the session between calls, so you sign in again only if TrueCoach logs you out.

Will my clients get a message or a notification?

Only from send_message, which asks for your OK first by default. create_workout and assign_program put workouts in the client's app and send no notification of their own; assign_program leaves notify_client off. TrueCoach itself can still send its daily workout email for a workout due today, and a client who is not logged in gets message text by email.

Does it write a workout with video demos?

When you give exercise_id from search_exercises, yes: the item links to that exercise and its video. Without it the item is plain text with your wording. create_exercise adds your own exercise, but TrueCoach requires a video link for it.

Is assign_program instant?

TrueCoach assigns in the background. The tool waits about 15 seconds and lists the assignments that appeared; queued is true when TrueCoach is still working. Completed and missed workouts are never touched, and workouts you added by hand stay when you unassign.

Can it add a new client?

No. TrueCoach guards client invites with a Cloudflare Turnstile check. Add the client in TrueCoach (an In-Person client needs only a name), then the agent can group them, assign a program, write workouts and message them.

What can it not do yet?

Not built: adding, archiving or editing clients, client notes, habits and nutrition, progress photos, copying or deleting a workout, creating or editing programs and groups, forms, payments and the calendar of in-person sessions. Messages carry no attachments, and metrics must already be assigned to the client.

Does TrueCoach have webhooks?

No. The 4 Zapier triggers on Pro are the only events TrueCoach sends out. To react to completed or missed workouts, run your agent on a schedule and read the dashboard and the calendars.

Can it write a week from a Google Doc?

Yes. Paste the text and name the client: create_workout puts each day on the calendar, keeps your cues word for word and tells you which moves have no match in your exercise library.

Is the MCP server different from the REST API?

Only the way in. Both have the same 16 tools, inputs and answers, one API key and one price. Agents use MCP; scripts, cron jobs and HTTP steps use REST.

Is Cotlet affiliated with TrueCoach?

No. Cotlet is independent and not affiliated with TrueCoach, Inc. or Xplor Technologies.

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.