MCP Server
Booked55 exposes a Model Context Protocol (MCP) server that lets AI assistants — including ChatGPT, Claude, and any MCP-compatible client — read and write your CRM data using natural language.
What is MCP?
MCP is an open protocol that standardises how AI models communicate with external tools and data sources. Instead of building custom integrations for every AI client, MCP provides a single interface that any compatible application can use.
With the Booked55 MCP server you can ask your AI assistant to create contacts, search companies, update pipeline deals, manage tasks, and more — all from a conversational interface.
Server endpoint
The production MCP server is available at:
https://mcp.booked55.comThis is the URL you provide when connecting an AI client such as ChatGPT or Claude. Enter it exactly as shown, with no path after it.
Available tools
The server currently exposes 72 tools in 14 groups:
| Category | Tools |
|---|---|
| Contacts | list_contacts, get_contact, create_contact, update_contact, set_contact_photo, search_contacts, bulk_add_event_to_contacts, bulk_update_contacts_pipeline |
| Contact import | get_contact_import_format, validate_contacts_csv, import_contacts_csv |
| Companies | list_companies, get_company, create_company, update_company, search_company, search_company_ai |
| Events | list_events, get_event, create_event, search_event |
| Tasks | list_tasks, get_task, create_task, update_task, skip_task |
| Notes | list_notes, create_note, update_note |
| Pipelines | list_pipelines, list_pipeline_stages, list_client_types, create_pipeline_item, update_pipeline_item |
| Deals | list_deals, get_deal, create_deal, update_deal, delete_deal, get_deals_scoreboard, get_deals_on_date, get_deal_revenue_metrics, get_contact_deal_summary |
| Design system | get_design_system, read_design_system_files, save_design_system_file |
| Email templates | list_email_templates, get_email_template, create_email_template, update_email_template, upload_email_image, create_email_image_upload_link, list_email_images |
| Campaigns | list_campaigns, get_campaign, save_campaign, send_test_email, launch_campaign, get_campaign_results |
| Sequences | list_sequences, get_sequence, save_sequence, set_sequence_status, update_sequence_contacts, get_sequence_results |
| Newsletters | list_newsletters, get_newsletter, save_newsletter, update_newsletter_subscribers, create_newsletter_issue |
| Support | request_callback, send_feedback |
Stage IDs come from list_pipeline_stages, not list_pipelines, which returns pipelines only. Over OAuth, the three contact-import tools and list_client_types need write:contacts even though some of them only read, because Booked55 gates them on permission to create contacts. See Authentication.
Only one tool deletes. delete_deal removes a recorded sale, and it is the single exception — there is no delete tool for a contact, company, event, task, note or pipeline item. It also needs its own delete:deals consent, which is granted separately from reading and writing, so a connection can record deals without ever being able to remove one. Everywhere else an AI client can read and write your CRM, but removing a record stays something a person does: correcting a note is update_note, which replaces its text, and adding to a record's history is create_note, which overwrites nothing. Taking one person off a campaign draft, out of a sequence or off a newsletter is not a deletion either: the contact stays, and it needs only write:contacts.
Nothing is sent without asking you. Campaigns, sequences and newsletters can be written, edited and filled with people freely, but the four tools that make email leave your mailbox — send_test_email, launch_campaign, set_sequence_status when it activates or resumes, and update_sequence_contacts when it enrolls people — need the separate send:email consent, and the AI shows you what will go out and waits for your go-ahead first. A newsletter issue is sent with launch_campaign, like any campaign.
See Available Tools for detailed descriptions, parameters, and example prompts.
Authentication
The MCP server supports two authentication methods:
- OAuth 2.0 with PKCE — used by ChatGPT, Claude and other AI clients you sign in to. You authorise via your Booked55 login. Claude and ChatGPT need only the server URL: no client ID or secret.
- API key — for programmatic access. Create a key from Workspace Settings → API Keys.
See Authentication for full details on scopes, tokens, and the OAuth flow.
Connecting your AI client
Follow our step-by-step guides to connect your AI assistant:
Try the MCP Server
Sign up for Booked55, connect ChatGPT or Claude, and manage your CRM with natural language.