[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Treatwell API and MCP server: Let your AI agent keep the salon diary full.

> Treatwell publishes no public API for Treatwell Connect. Its AI information page describes the product for assistants such as ChatGPT and Claude, but it is reference text: no MCP server, connector or developer access.

Treatwell publishes no public API and no MCP server for Treatwell Connect (checked 14 Nov 2026). Cotlet runs a hosted Treatwell MCP server with 12 tools that ChatGPT and Claude use in your own salon account. Offers, replies and anything clients see wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Treatwell
- Page: https://cotlet.dev/integrations/treatwell-api-mcp-server

## What can your AI agent do in Treatwell Connect?

- Sum up new and cancelled bookings
- Find quiet hours from fill rate
- Create an offer for empty slots
- Reply to reviews
- Brief stylists on tomorrow's clients
- Block time off and move bookings

## Does Treatwell have an MCP server or an API?

- Treatwell Connect runs in a web browser on Windows and Mac and in iOS and Android apps.
- Its own integrations are Google Business Profile (Reserve with Google), Google Calendar, iCloud Calendar and booking widgets for websites and social media.
- Marketplace clients and a salon's own clients land in the same Treatwell Connect calendar.

| What you need | Calendar sync | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No | Copy and paste | Hosted MCP server |
| See appointments outside Treatwell | Google or iCloud Calendar | In Treatwell Connect | view_calendar |
| Offers, reviews, client notes, reports | Not in a calendar | One screen at a time | 12 tools, writes after your OK |
| Run from n8n or a script | Read the synced calendar | Manual only | REST, same key |

Checked 14 Nov 2026. Sources: [Treatwell AI Instructions + Information (last updated 1 Oct 2026)](https://www.treatwell.co.uk/partners/ai-instructions/), [Treatwell for business](https://www.treatwell.co.uk/partners/), [Treatwell Partner Help Centre](https://partnercare.treatwell.com/s/), [Treatwell Connect on the App Store](https://apps.apple.com/gb/app/treatwell-connect-for-salons/id824245836)

## How does the Treatwell MCP server work?

1. **Log in to Treatwell Connect.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the diary.** Read fill rate, then approve the offer.

Cotlet never sees or stores your password. Writes, and anything clients see, wait for your OK.

## How to connect Treatwell Connect to your AI agent

1. **Log in to Treatwell Connect in a Cloud Browser.** Open connect.treatwell.co.uk/login in your Cotlet Cloud Browser and log in with your own Treatwell Connect login.
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.

Treatwell shares the address `https://cotlet.dev/mcp/v1` with every other app you turn on, so one connector covers them all. Turned Treatwell on after connecting? Refresh the connector and the 12 Treatwell tools appear.

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: list_booking_changes
```

## All 12 Treatwell MCP tools

One tool per Treatwell Connect feature. Tools with an `action` read on `list` and `get`; the other actions write and ask first.

### Calendar and bookings

Every booking source in one calendar: marketplace, website, Google and social.

- **View the salon calendar** (`view_calendar`, read): Read the Treatwell Connect calendar for a day or week, across staff and locations.
- **Review new online bookings** (`list_booking_changes`, read): Read new bookings, changes and cancellations since a time you give.
- **Book and edit appointments** (`manage_appointments`, write, asks first): Book an appointment, move it to another time or team member, or cancel it.
- **Block time for breaks and time off** (`block_time`, write, asks first): Block a team member's time in the calendar for a break or time off.
- **Set cancellation and no-show policies** (`set_no_show_policy`, write, asks first): Read or change your cancellation and no-show policy and online pre-payment.

### Clients and checkout

Treatment history, preferences and notes, imports, and payments at the till.

- **Manage client records** (`manage_clients`, write, asks first): Find a client, read their treatment history and notes, or add a client or a note.
- **Import client lists** (`import_clients`, write, asks first): Import a client list or contact book into Treatwell Connect.
- **Record payments at checkout** (`record_payment`, write, asks first): Check out an appointment in Treatwell Connect's point of sale, including vouchers and packages.

### Marketing and reputation

Offers for quiet hours, replies to reviews and the profile marketplace clients read.

- **Create promotions and last-minute offers** (`create_promotion`, write, asks first): List your promotions or create one for quieter hours or empty slots.
- **Reply to reviews** (`reply_to_review`, write, asks first): List your reviews or post a reply to one.
- **Update the marketplace profile** (`update_marketplace_profile`, write, asks first): Read or update your venue profile and team portfolios on the Treatwell marketplace.

### Reports

Revenue, staff performance, fill rate, repeat visits and most-booked treatments.

- **View business reports** (`view_reports`, read): Read revenue, staff performance, fill rate, repeat visits and most-booked treatments.

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

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

- **What we store.** Your signed-in Treatwell Connect browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 12 Treatwell tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** What your Treatwell Connect login's permissions allow. A stylist's own login gives the agent that stylist's view.
- **What no tool touches.** Team logins and permissions, payouts, Tap to Pay, your SMS reminder setup and the Google and calendar integrations.
- **If Treatwell signs you out.** You log in again yourself, in the same Cloud Browser.
- **How to cut access.** Turn Treatwell off for agents, reset the browser, or change your Treatwell Connect password.

Cotlet never sees or stores your password. You type it into Treatwell Connect yourself, and the agent only uses the session that login leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## What happens when Treatwell changes?

Cotlet watches the apps it serves and updates the Treatwell server when Treatwell Connect changes its pages, so your agent keeps working without a change on your side.

Treatwell Connect is available in several European countries. The agent works in the Treatwell Connect account your login opens, for the country it belongs to.

If Treatwell signs you out, one click in the Cotlet console reopens the Cloud Browser so you can log in again.

## Approvals, undo and mistakes

1. **Read fill rate.** view_reports returns each team member.
2. **Find the empty hours.** view_calendar shows the gaps.
3. **Show you the offer.** Treatments, discount and times, before it is saved.
4. **Save after your OK.** create_promotion adds it in Treatwell Connect.

| Action | How to put it right |
|---|---|
| Appointment moved | Move it back with manage_appointments |
| Blocked time, policy, profile text | Call the same tool again with the earlier values |
| Client note | Add a correcting note with manage_clients |
| Review reply or offer clients already saw | Public already: follow up with the client yourself |

All 9 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 3 read tools, the calendar, booking changes and reports, run at once.

MCP call:

```
{
  "name": "create_promotion",
  "arguments": {
    "action": "create",
    "kind": "quiet_hours",
    "treatments": [
      "Gel manicure"
    ],
    "discount_percent": 20,
    "when": "Tue to Wed, 10:00 to 13:00"
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/treatwell/promotions \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"create","kind":"quiet_hours","treatments":["Gel manicure"],"discount_percent":20,"when":"Tue to Wed, 10:00 to 13:00"}'
```

Response:

```
{
  "kind": "quiet_hours",
  "treatments": [
    "Gel manicure"
  ],
  "discount_percent": 20,
  "when": "Tue to Wed, 10:00 to 13:00",
  "saved": true
}
```

The example saves a 20% gel manicure offer for Tuesday and Wednesday mornings, the hours the fill rate report showed empty. A cron job or n8n flow can make the same call over REST at `/api/v1/treatwell` with the same key and price, in JSON. Failed calls are free.

## How much does the Treatwell MCP server cost?

**About $20 a month** for a salon with three stylists, 3,480 credits. Your Treatwell plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Morning summary of new bookings | 2 × 26 | 520 |
| Client notes before visits | 1 × 60 | 600 |
| Appointment moves and cancellations | 2 × 25 | 500 |
| Breaks and time off | 1 × 10 | 100 |
| Weekly fill rate and quiet-hours offer | 3 × 4 | 120 |
| Weekly review replies | 3 × 4 | 120 |
| Monthly revenue and staff reports | 2 × 1 | 20 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 198 calls | 3,480 |

The smallest pack, 5,000 credits for $29, covers this month. A salon group with several locations 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 Treatwell 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.

## Treatwell MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Google Calendar and iCloud Calendar sync | Treatwell Connect's own calendar integrations. | Calendar entries only: no clients, offers, reviews or reports. |
| Reserve with Google and booking widgets | Clients book from Google, your website and social media. | Bookings in; nothing an agent can call. |
| Treatwell Connect by hand | Every tool on this page, on the web or in the app. | One screen at a time, only while someone is at the desk. |

If all you need is your appointments in another calendar, Treatwell's own Google or iCloud sync is free and enough. Cotlet fits when you want ChatGPT, Claude or a script working on bookings, offers and reviews in Treatwell Connect from your own login, with nothing to host.

## Who runs Cotlet

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

## Treatwell MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=treatwell, turn on Treatwell under Integrations in the console and log in at https://connect.treatwell.co.uk/login in your Cloud Browser. Then connect your AI agent and ask what was booked overnight. The trial needs no card.

### Does Treatwell have an API?

Treatwell publishes no public API for Treatwell Connect (checked 14 Nov 2026). Its AI information page describes the product for assistants such as ChatGPT and Claude, but offers no MCP server, connector or developer access. Cotlet does not need one: it works in your own signed-in Treatwell Connect account.

### Do bookings from the Treatwell marketplace show up for the agent?

Yes. Treatwell says marketplace clients land in the same Treatwell Connect calendar as your own clients, so view_calendar and list_booking_changes return them alongside the rest.

### Does the agent change SMS reminders?

No. Treatwell Connect sends its SMS and email reminders automatically and without per-message charges. set_no_show_policy changes only the cancellation and no-show policy and pre-payment.

### Which Treatwell Connect login should I use?

The one whose work the agent should do. Treatwell Connect gives each team member a login with its own permissions, and the agent sees exactly what that login sees.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 12 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Treatwell?

No. Cotlet is independent and not affiliated with Treatwell.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

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](https://cotlet.dev/about.md)

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.
