Skip to main content
Glama
README.md
# Booker MCP server for ChatGPT and Claude

Connect ChatGPT, Claude and any AI agent to your Booker salon or spa account through Cotlet.dev. The hosted integration documents 14 operations for appointments, client messages, marketing and sales.

## What can I ask?

> Show tomorrow's appointments by staff member.

> Read unread client texts and prepare a reply for my approval.

> Check the calendar, then move a booking after I confirm the new time.

> Find tomorrow's open slots and show me the audience and message before offering them to clients.

## Connect ChatGPT and Claude

1. [Get access](https://cotlet.dev/signup?app=booker).
2. Turn on Booker in the Cotlet.dev console. Open https://signin.booker.com in your Cloud Browser and sign in with your own account name and staff login.
3. Add `https://cotlet.dev/mcp/v1/connect` as the connector URL in ChatGPT or Claude and sign in with Cotlet.dev.

Codex, Claude Code and other clients using an API key connect to `https://cotlet.dev/mcp/v1`. Create a key in the Cotlet.dev console and configure your client:

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

[Current client setup and full Booker guide](https://cotlet.dev/integrations/booker-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=booker)

## Hosted operations

The live page documents these operations through `booker_read` and `booker_write`:

- `list_appointments`
- `manage_appointments`
- `record_sale`
- `text_clients`
- `manage_reminders`
- `collect_intake_forms`
- `manage_contact_lists`
- `manage_email_templates`
- `send_promotion`
- `manage_marketing_automations`
- `reward_loyal_clients`
- `request_client_reviews`
- `fill_last_minute_openings`
- `manage_staff_profiles`

Calendar reads run without confirmation. Write actions ask for confirmation by default; you can change this per tool. Tools with an action parameter can also list or get information. Review bookings, recorded sales, messages, promotions and automations before confirming them. Features depend on your Booker plan, region and staff permissions. Staff logins, permissions, payment processing settings and your Booker subscription are outside these tools.

## Run the local stdio bridge

This repository includes a Python bridge to Cotlet.dev. It requires Python 3.10 or newer and uses the standard library.

```bash
export COTLET_API_KEY="your-key"
python3 booker_agent.py serve
```

The local bridge exposes seven browser helper tools: `booker_guide`, `booker_status`, `booker_open`, `booker_read`, `booker_click`, `booker_type` and `booker_close`. The hosted connector exposes the application operations listed above. Use the hosted connector for those operations.

```bash
docker build -t booker-mcp .
docker run -i --rm -e COTLET_API_KEY booker-mcp
```

Without `COTLET_API_KEY`, a tool call returns instructions for obtaining a key. Keep the key out of source control.

## Does Booker have an API or an official MCP server?

The live guide, checked 19 November 2026, describes Booker's API for custom online booking sites. No official Booker MCP server or ChatGPT or Claude connector was found in that check. If Booker's official API or integrations cover your task, use them first.

## Is this affiliated with Booker?

Cotlet.dev is independent and is not affiliated with, endorsed by or sponsored by Booker. Booker is a trademark of its owner. You use your own Booker account and its existing plan and permissions.

[Get access](https://cotlet.dev/signup?app=booker)

TDQS

A3.7/5.0

Scored across 7 tools

Disambiguation5/5

Each tool targets a distinct step in a browser-session workflow: guide is static documentation, status checks account/connection readiness, and open/read/click/type/close map one-to-one onto discrete browser primitives. The only mild adjacency is guide vs. status (both are pre-flight orientation), but their outputs and purposes are clearly separable.

Naming Consistency5/5

Every tool uses the same booker_ prefix followed by a single lowercase verb or noun (guide, status, open, read, click, type, close), with no mixing of camelCase, snake_case, or verb/noun styles. The set is fully predictable.

Tool Count5/5

Seven tools is a tight, well-scoped surface for a browser-automation wrapper over one SaaS product: two orientation tools plus five primitives that form a complete act-observe loop. No tool looks redundant or padded.

Completeness4/5

The open/read/click/type/close loop covers the core lifecycle of driving a signed-in session, including explicit credit-saving teardown. Minor gaps remain for richer interaction such as selecting dropdown options, sending key presses (Enter/Escape), or waiting for async page loads, which agents may have to work around by clicking.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues