TotalCoaching MCP Server
README.md
# TotalCoaching API and MCP server for ChatGPT and Claude
Connect ChatGPT, Claude and other AI agents to your TotalCoaching account through Cotlet.dev. Review client programs, exercise results, training calendars and coaching feedback in your signed-in Cloud Browser.
## What you can ask
> Read a client's assigned program.
> Review exercise results for the week.
> Find the latest client feedback.
> Prepare a selected coaching message.
> Review the exercise library.
> Check the client's next planned sessions.
## Connect your AI agent
Get your API key at https://cotlet.dev/app and export it as `COTLET_API_KEY`.
### ChatGPT
Settings > Apps & Connectors > Create. Use `https://cotlet.dev/mcp/v1/connect` with OAuth.
### Claude
Settings > Connectors > Add custom connector. Use `https://cotlet.dev/mcp/v1/connect`.
### Claude Code
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
### Cursor
Copy `.cursor/mcp.json` from this repo into your project:
```json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
```
## Run it locally (stdio)
This repository provides a local MCP bridge to the hosted Cotlet.dev service.
It lists seven browser tools without a key. Account calls require your Cotlet API key.
Run it directly from this repository with Python 3.10 or later:
```bash
python3 totalcoaching_agent.py serve
```
Or with Docker:
```bash
docker build -t totalcoaching-mcp .
docker run -i --rm -e COTLET_API_KEY totalcoaching-mcp
```
Tools: `totalcoaching_guide`, `totalcoaching_status`, `totalcoaching_open`, `totalcoaching_read`, `totalcoaching_click`, `totalcoaching_type`, `totalcoaching_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
## Command line
Python 3.10+, using only the Python standard library:
```bash
export COTLET_API_KEY="your-key"
python3 totalcoaching_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 totalcoaching_agent.py status # is TotalCoaching ready in your Cotlet.dev account
python3 totalcoaching_agent.py guide # TotalCoaching screens and sign-in link
python3 totalcoaching_agent.py read # open TotalCoaching, read the page, close the browser
python3 totalcoaching_agent.py tools # list Cotlet.dev tools
python3 totalcoaching_agent.py serve # start the stdio MCP server (same as no argument)
```
## Questions from TotalCoaching users
**Does TotalCoaching have an API or official MCP server?**
The Cotlet.dev page, checked 12 November 2026, reports no general-purpose record-management API reference or official TotalCoaching MCP server or ChatGPT or Claude connector in the vendor sources reviewed.
**How does Cotlet connect to TotalCoaching?**
Sign in to TotalCoaching in your Cotlet Cloud Browser and connect your AI agent using the instructions in your console. Your agent works in your own account.
**Is Cotlet affiliated with TotalCoaching?**
No. Cotlet.dev is independent and is not affiliated with TotalCoaching.
## Learn more
[TotalCoaching on Cotlet.dev](https://cotlet.dev/integrations/totalcoaching-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=totalcoaching)
---
More: https://cotlet.dev/integrations/totalcoaching-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=totalcoaching
Start free: https://cotlet.dev/signup?app=totalcoaching&utm_source=github&utm_medium=readme&utm_campaign=totalcoaching