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

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
Treatwell logo Treatwell Cloud Browser

12 tools Read and write

Salons, barbers and spas

What can your AI agent do in Treatwell Connect? The front desk work around a busy diary.

  • 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

No API, no MCP

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

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 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.
Treatwell's own routes and Cotlet compared
What you need Calendar syncBy handCotlet
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) · Treatwell for business · Treatwell Partner Help Centre · Treatwell Connect on the App Store

Set up once

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

  1. 1Log in to Treatwell Connect

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

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

Any MCP client

How to connect Treatwell Connect to your AI agent

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

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
3 read, 9 write

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 bookings5

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

  • view_calendar Read the Treatwell Connect calendar for a day or week, across staff and locations. read

    Returns appointments with client, treatment, team member and time, including bookings that came from the Treatwell marketplace. Nothing changes, so it runs without asking.

    MCP calltreatwell_read → view_calendar

    REST endpointGET https://cotlet.dev/api/v1/treatwell/calendars/view

    Parameters

    Parameters: view_calendar
    NameTypeDescription
    date string string ISO date. Defaults to today.
    range string string `day` or `week`. Defaults to `day`.
    staff string string Optional team member. Leave empty for everyone.
    location string string Optional location, for salons with more than one.

    Example response

    {
      "date": "2026-11-18",
      "appointments": [
        {
          "time": "10:00",
          "staff": "Stylist A",
          "client": "Example Client A",
          "treatment": "Cut and blow dry",
          "price": 55
        },
        {
          "time": "11:30",
          "staff": "Stylist B",
          "client": "Example Client B",
          "treatment": "Full head highlights",
          "price": 140
        }
      ]
    }
  • list_booking_changes Read new bookings, changes and cancellations since a time you give. read

    Treatwell Connect alerts you to new bookings, changes and cancellations from the Treatwell app and marketplace, your website, Google and social media. This reads them back as a list. Read only.

    MCP calltreatwell_read → list_booking_changes

    REST endpointGET https://cotlet.dev/api/v1/treatwell/booking-changes

    Parameters

    Parameters: list_booking_changes
    NameTypeDescription
    since string required string ISO date and time.
    source string string Optional: `marketplace`, `website`, `google` or `social`, when Treatwell Connect shows where the booking came from.

    Example input

    {
      "since": "since"
    }

    Example response

    {
      "since": "2026-11-17T18:00",
      "changes": [
        {
          "kind": "new",
          "client": "Example Client C",
          "treatment": "Gel manicure",
          "start": "2026-11-19T15:00",
          "source": "marketplace"
        },
        {
          "kind": "cancelled",
          "client": "Example Client D",
          "treatment": "Brow shape",
          "start": "2026-11-18T16:00"
        }
      ]
    }
  • manage_appointments Book an appointment, move it to another time or team member, or cancel it. writeAsks first

    Changes land in the same calendar your team and the marketplace use, and Treatwell Connect sends its notifications for them, so every change waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → manage_appointments

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/appointments/manage

    Parameters

    Parameters: manage_appointments
    NameTypeDescription
    action string required string One of `book`, `move`, `cancel`. All three write.
    appointment string string For `move` and `cancel`: the appointment, by client and time.
    client string string For `book`: client name from manage_clients.
    treatment string string For `book`: a treatment on your menu.
    staff string string Team member.
    start string string For `book` and `move`: ISO date and time.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "action": "move",
      "client": "Example Client B",
      "treatment": "Full head highlights",
      "from": "2026-11-18T11:30",
      "to": "2026-11-19T14:00",
      "staff": "Stylist B",
      "saved": true
    }
  • block_time Block a team member's time in the calendar for a break or time off. writeAsks first

    Blocked time is not offered for online booking, so the agent checks the calendar for clashes and asks first. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → block_time

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/time/block

    Parameters

    Parameters: block_time
    NameTypeDescription
    staff string required string Team member.
    from string required string ISO date and time.
    to string required string ISO date and time.
    reason string string `break` or `time_off`.

    Example input

    {
      "staff": "staff",
      "from": "from",
      "to": "to"
    }

    Example response

    {
      "staff": "Stylist A",
      "from": "2026-12-24T09:00",
      "to": "2026-12-24T18:00",
      "reason": "time_off",
      "saved": true
    }
  • set_no_show_policy Read or change your cancellation and no-show policy and online pre-payment. writeAsks first

    Reminders by SMS and email are automatic and unlimited in Treatwell Connect; this tool reads and changes the policy clients agree to. Clients see the policy when they book, so a change waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → set_no_show_policy

    REST endpointPUT https://cotlet.dev/api/v1/treatwell/no-show-policy

    Parameters

    Parameters: set_no_show_policy
    NameTypeDescription
    action string required string One of `get`, `set`. `get` only read.
    settings object object For `set`: the policy fields as Treatwell Connect offers them, such as cancellation window and pre-payment.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "cancellation_window_hours": 24,
      "prepayment": "Online pre-payment for new clients",
      "saved": true
    }

Clients and checkout3

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

  • manage_clients Find a client, read their treatment history and notes, or add a client or a note. writeAsks first

    A Treatwell Connect client record holds treatment history, preferences, personal notes, consultation forms and marketing consent. `get` returns them; the agent writes notes exactly as you give them. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → manage_clients

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/clients/manage

    Parameters

    Parameters: manage_clients
    NameTypeDescription
    action string required string One of `list`, `get`, `create`, `add_note`. `list` and `get` only read.
    client string string Client name or phone, for `get` and `add_note`, or a search for `list`.
    fields object object For `create`: name, phone, email.
    note string string For `add_note`: the note, in your words.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "client": "Example Client A",
      "last_visits": [
        {
          "date": "2026-10-21",
          "treatment": "Cut and blow dry"
        }
      ],
      "preferences": "Prefers Saturday mornings",
      "marketing_consent": true
    }
  • import_clients Import a client list or contact book into Treatwell Connect. writeAsks first

    Treatwell says salons can import any type of client list. The agent shows what it is about to import and imports after your OK. A move from another salon system can also go through Treatwell's customer service team. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → import_clients

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/clients

    Parameters

    Parameters: import_clients
    NameTypeDescription
    file_url string required string A link the Cloud Browser can download the list from.

    Example input

    {
      "file_url": "https://example.com"
    }

    Example response

    {
      "file": "clients.csv",
      "imported": 380,
      "saved": true
    }
  • record_payment Check out an appointment in Treatwell Connect's point of sale, including vouchers and packages. writeAsks first

    Payments land in Treatwell Connect's automatic transaction reporting, with no separate till reconciliation. Money is involved, so the agent repeats client, amount and method first. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → record_payment

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/payments

    Parameters

    Parameters: record_payment
    NameTypeDescription
    appointment string required string The appointment, by client and time.
    method string required string A payment method your till offers, or a voucher or package. Tap to Pay needs the phone and stays there.
    amount number number Defaults to the appointment total.

    Example input

    {
      "appointment": "appointment",
      "method": "method"
    }

    Example response

    {
      "client": "Example Client A",
      "treatment": "Cut and blow dry",
      "amount": 55,
      "method": "Card",
      "paid": true
    }

Marketing and reputation3

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

  • create_promotion List your promotions or create one for quieter hours or empty slots. writeAsks first

    Offers appear to clients who book online, so the agent shows the treatments, discount and times before it saves one. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → create_promotion

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/promotions

    Parameters

    Parameters: create_promotion
    NameTypeDescription
    action string required string One of `list`, `create`. `list` only read.
    kind string string For `create`: `quiet_hours` or `last_minute`.
    treatments array array Treatments the offer covers.
    discount_percent number number The discount.
    when string string Days and hours the offer runs.

    Example input

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

    Example response

    {
      "kind": "quiet_hours",
      "treatments": [
        "Gel manicure"
      ],
      "discount_percent": 20,
      "when": "Tue to Wed, 10:00 to 13:00",
      "saved": true
    }
  • reply_to_review List your reviews or post a reply to one. writeAsks first

    Treatwell asks every client for a review after the appointment, and only clients who attended can leave one. A reply is public, so it waits for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → reply_to_review

    REST endpointPOST https://cotlet.dev/api/v1/treatwell/review/replies

    Parameters

    Parameters: reply_to_review
    NameTypeDescription
    action string required string One of `list`, `reply`. `list` only read.
    review string string For `reply`: the review, by client and date.
    reply string string For `reply`: your public answer.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "reviews": [
        {
          "client": "Example Client A",
          "rating": 5,
          "date": "2026-11-15",
          "replied": false
        },
        {
          "client": "Example Client E",
          "rating": 3,
          "date": "2026-11-14",
          "replied": false
        }
      ]
    }
  • update_marketplace_profile Read or update your venue profile and team portfolios on the Treatwell marketplace. writeAsks first

    The venue profile is what marketplace clients see before they book, so changes wait for your OK. By default you confirm each call; you can switch that off for this tool.

    MCP calltreatwell_write → update_marketplace_profile

    REST endpointPATCH https://cotlet.dev/api/v1/treatwell/marketplace-profile

    Parameters

    Parameters: update_marketplace_profile
    NameTypeDescription
    action string required string One of `get`, `update`. `get` only read.
    fields object object For `update`: description, photos (as links) or a team member's portfolio.

    Example input

    {
      "action": "action"
    }

    Example response

    {
      "venue": "Example Hair Studio",
      "description": "Colour specialists in the city centre.",
      "photos": 8,
      "team_portfolios": 3
    }

Reports1

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

  • view_reports Read revenue, staff performance, fill rate, repeat visits and most-booked treatments. read

    Reads the Treatwell Connect dashboards for the dates you give, as your login sees them. Nothing changes.

    MCP calltreatwell_read → view_reports

    REST endpointGET https://cotlet.dev/api/v1/treatwell/reports/view

    Parameters

    Parameters: view_reports
    NameTypeDescription
    report string required string `revenue`, `staff_performance`, `fill_rate`, `repeat_visits` or `top_treatments`.
    from string string ISO date.
    to string string ISO date.

    Example input

    {
      "report": "report"
    }

    Example response

    {
      "report": "fill_rate",
      "from": "2026-11-10",
      "to": "2026-11-16",
      "staff": [
        {
          "name": "Stylist A",
          "fill_rate": 82
        },
        {
          "name": "Stylist B",
          "fill_rate": 64
        }
      ]
    }
Encrypted, revocable

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

We keep it working

What happens when Treatwell changes? The tools work through the same Treatwell Connect pages your front desk uses.

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.

9 tools ask first

Approvals, undo and mistakes Clients see no offer, reply or change until you say so.

  1. 01 Read fill rate view_reports returns each team member.
  2. 02 Find the empty hours view_calendar shows the gaps.
  3. 03 Show you the offer Treatments, discount and times, before it is saved.
  4. 04 Save after your OK create_promotion adds it in Treatwell Connect.
Fixing a Treatwell write that went wrong
ActionHow to put it right
Appointment movedMove it back with manage_appointments
Blocked time, policy, profile textCall the same tool again with the earlier values
Client noteAdd a correcting note with manage_clients
Review reply or offer clients already sawPublic 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.

Pay per call

How much does the Treatwell MCP server cost?

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

Illustrative month, our assumption: successful calls for this workload
JobCallsCredits
Morning summary of new bookings2 × 26520
Client notes before visits1 × 60600
Appointment moves and cancellations2 × 25500
Breaks and time off1 × 10100
Weekly fill rate and quiet-hours offer3 × 4120
Weekly review replies3 × 4120
Monthly revenue and staff reports2 × 120
Cloud Browser, 30 days1,500
Total198 calls3,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.

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

Treatwell MCP server: other ways to connect What each route does for a salon on Treatwell Connect, and where it stops.

Other ways to work with Treatwell Connect, checked 14 Nov 2026
OptionWhat it doesWhere it stops
Google Calendar and iCloud Calendar syncTreatwell Connect's own calendar integrations.Calendar entries only: no clients, offers, reviews or reports.
Reserve with Google and booking widgetsClients book from Google, your website and social media.Bookings in; nothing an agent can call.
Treatwell Connect by handEvery 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.

EU company, since 2019

Who runs Cotlet A company you can look up.

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.

Hand your Treatwell diary to your agent.

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