Skip to main content
Glama
Treatwell MCP Server

Treatwell MCP Server

Treatwell MCP server

Connect Treatwell Connect to ChatGPT, Claude and any AI agent through Cotlet.dev. Read bookings and fill rate, prepare offers for quiet hours and manage your salon diary in your own signed-in account. Write actions ask for approval by default.

What you can ask

Summarize new bookings and cancellations since yesterday.

Find quiet hours in next week's calendar and draft an offer for my approval.

Read this month's revenue and staff performance reports.

Related MCP server: appointy-mcp

Connect in 2 minutes

Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.

ChatGPT

Settings → Apps & Connectors → Create, with connector URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev. No API key needed.

Claude

Settings → Connectors → Add custom connector, with URL https://cotlet.dev/mcp/v1/connect, then sign in with Cotlet.dev.

Claude Code

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:

{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${COTLET_API_KEY}"
      }
    }
  }
}

Run it locally (stdio)

This repo is a real MCP server. It speaks MCP over stdio, lists its Treatwell tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.

Run the included Python module with Python 3.10 or later:

python3 treatwell_agent.py serve

Or with Docker:

docker build -t treatwell-mcp .
docker run -i --rm -e COTLET_API_KEY treatwell-mcp

Tools: treatwell_guide, treatwell_status, treatwell_open, treatwell_read, treatwell_click, treatwell_type, treatwell_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+, with no third-party runtime dependencies. Clone this repository and run:

export COTLET_API_KEY="your-key"
python3 treatwell_agent.py connect   # ready config for ChatGPT, Claude, Claude Code and Cursor
python3 treatwell_agent.py status    # is Treatwell ready in your Cotlet.dev account
python3 treatwell_agent.py guide     # Treatwell screens and sign-in link
python3 treatwell_agent.py read      # open Treatwell, read the page, close the browser
python3 treatwell_agent.py tools     # list Cotlet.dev tools
python3 treatwell_agent.py serve     # start the stdio MCP server (same as no argument)

Questions from Treatwell users

Which Treatwell Connect login should I use?

Use the login whose work the agent should do. The agent sees what that login's permissions allow.

Do marketplace bookings appear?

Treatwell marketplace bookings and your own clients share the Treatwell Connect calendar.

Is Cotlet affiliated with Treatwell?

No. Cotlet.dev is independent and not affiliated with Treatwell.

Learn more


More: https://cotlet.dev/integrations/treatwell-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=treatwell

Request access: https://cotlet.dev/signup?app=treatwell&utm_source=github&utm_medium=readme&utm_campaign=treatwell

Workflows on the hosted integration

The live integration page documents these 12 operations:

  • view_calendar

  • list_booking_changes

  • manage_appointments

  • block_time

  • set_no_show_policy

  • manage_clients

  • import_clients

  • record_payment

  • create_promotion

  • reply_to_review

  • update_marketplace_profile

  • view_reports

The local stdio adapter exposes seven browser helpers listed above. These helpers forward to Cotlet.dev; the workflow operations are documented on the hosted integration page.

Available Tools

7 tools
treatwell_clickB

Click a numbered element on the current Treatwell page.

Inputs: element (required).

treatwell_closeA

Close the Treatwell browser session when the work is done, so credits stop running.

Inputs: no named parameters.

treatwell_guideA

How to work in Treatwell (manage salon appointments, clients, offers, reviews and reports): its screens and the sign-in link. Call this first.

Inputs: task.

treatwell_openB

Open a Treatwell page in your signed-in Cloud Browser (default https://connect.treatwell.co.uk) to work with manage salon appointments, clients, offers, reviews and reports.

Inputs: url.

treatwell_readA

Read the current Treatwell page: its text and numbered buttons, links and fields.

Inputs: element.

treatwell_statusA

Check that your Cotlet.dev account and Treatwell are ready: account, credits and Treatwell connection.

Inputs: no named parameters.

treatwell_typeB

Type text into a numbered field on the current Treatwell page.

Inputs: text (required), element (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool maps to a distinct role: guide is documentation, status is an account/connection health check, and open/read/click/type/close form an unambiguous browser-automation loop. The descriptions explicitly sequence them (guide first, read before click/type, close when done), so an agent can pick the right tool without guessing.

    Naming Consistency5/5

    All seven tools share the treatwell_ prefix followed by a single, consistent action verb (guide, status, open, read, click, type, close). There are no mixed conventions, casing inconsistencies, or redundant verb styles.

    Tool Count5/5

    Seven tools is a tight, well-scoped set: two onboarding/health tools plus five browser primitives that each earn their place. Nothing appears redundant or padded, and the surface is large enough to complete real work.

    Completeness4/5

    The open/read/click/type/close loop covers navigation, inspection, and form interaction for the Treatwell web UI, with open accepting a target URL. Minor gaps exist around keyboard actions (Enter/submit shortcuts) and native selects, but those are largely workable by clicking numbered elements or submit buttons.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Connects a signed-in Appointy account to AI agents so users can book, reschedule, cancel appointments, send reminders, and inspect staff schedules using natural language.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Connects a signed-in Phorest account to AI agents, enabling natural-language appointment booking and rebooking, schedule and gap checks, client history queries, and client-card notes without a Phorest API key.
      7
      Elastic 2.0
    • A
      license
      A
      quality
      B
      maintenance
      Connects ChatGPT, Claude, and other AI agents to a signed-in Zenoti account so they can work with appointments, guest conversations, reviews, and reports. Write operations require approval by default.
      7
      Elastic 2.0