Use bookme with Claude and other AI assistants
Connect Claude, ChatGPT or any app that supports MCP. Ask in plain words and the assistant works in your bookme account, with you in control of every change.
https://bookme.brandid.app/mcpWhat you can ask
The assistant uses the same rules as your dashboard: your working hours, notice, buffers, caps, calendars and plan limits all apply.
- Create a 45 minute "Strategy Call" on Zoom, Monday and Thursday 10 to 4.
- What meetings do I have tomorrow, and who booked them?
- Block next Friday, I am at a conference.
- Move my 3 pm with Ivy to any open time on Thursday.
- Mark yesterday's meetings: Ana met, Ben did not show.
- How many no-shows did I have last month, by event type?
- What did I promise Omar in our last meeting, and what is still open?
- Draft a reminder email for my webinar, one day before it starts.
- Who are my most frequent clients, and who has not booked in 3 months?
- Give me the embed code for my Discovery Call on a popup button.
bookme also offers ready-made commands: daily briefing, weekly review, set up an event type, record outcomes, follow up no-shows, plan time off and prepare a webinar. In Claude look for them in the chat's + menu; in Claude Code type / and pick one starting with mcp__bookme__.
Connect your AI app
Every app uses the server address above. You sign in to bookme (not to the AI app) and choose what it may do. Connecting needs a recent sign-in; if yours is older, bookme emails you a 6-digit code first. The same steps, with a copy button, are in bookme under MCP (AI Assistants), Apps.
Claude
Claude on the web, desktop and mobile. Free plans can add one custom connector; Pro, Max, Team and Enterprise more.
- On claude.ai or in the Claude desktop app, open Customize, then Connectors.
- Choose Add custom connector, name it bookme and paste the address above. Keep the sign-in options Claude picks and press Add.
- Press Connect: a bookme page opens. Sign in (type the 6-digit code if bookme emails you one), choose what Claude may do and press Allow.
- In a chat, turn bookme on from the + menu (Connectors) and ask, for example: "What meetings do I have tomorrow?"
Team and Enterprise: an owner first adds the connector in Organization settings, Connectors; then each member connects it. Claude lets you choose per tool: set look-ups to Always allow and keep changes on Needs approval.
ChatGPT
Apps that change things need a ChatGPT Business, Enterprise or Edu workspace, on the web. On Pro, ChatGPT can only look things up. Free and Plus cannot add custom apps.
- Open Settings, then Apps (called Connectors in older versions), then Advanced settings. Turn on Developer mode (on Business, a workspace admin may need to allow it first).
- Create an app: name it bookme, paste the address above, and keep the sign-in on OAuth.
- Sign in to bookme when asked, choose what ChatGPT may do, and press Allow.
- In a chat, add bookme from the + menu and ask what you need.
ChatGPT changes its menus often: if yours look different, look for adding an app or connector by its address.
Claude Code
In a terminal with Claude Code installed.
- Run this command:
claude mcp add --transport http bookme https://bookme.brandid.app/mcp - Then run
/mcpin Claude Code, choose bookme and sign in in the browser that opens.
Add --scope user to the command to have bookme in every project. The consent screen says "Runs on this computer".
Codex
The Codex CLI, its IDE extension and the ChatGPT desktop app share the same setup.
- Run these commands (the second one opens the sign-in):
codex mcp add bookme --url https://bookme.brandid.app/mcp codex mcp login bookme - Or add it to
~/.codex/config.tomlyourself:[mcp_servers.bookme] url = "https://bookme.brandid.app/mcp"
Cursor
Cursor on your computer.
- Open Cursor Settings, then MCP (Tools and Integrations), and add a custom MCP server. Or put this in
~/.cursor/mcp.json:{ "mcpServers": { "bookme": { "url": "https://bookme.brandid.app/mcp" } } } - Next to bookme, press Connect (or Login) and sign in to bookme in the browser.
VS Code
GitHub Copilot in VS Code, in Agent mode.
- Run MCP: Add Server from the Command Palette, choose HTTP, paste the address above and name it bookme. Or put this in
.vscode/mcp.json:{ "servers": { "bookme": { "type": "http", "url": "https://bookme.brandid.app/mcp" } } } - Start the server when VS Code asks and sign in to bookme in the browser. Then use Copilot Chat in Agent mode.
Windsurf
The Cascade panel in Windsurf.
- In Cascade, open MCP servers and choose to configure them. Add this to the MCP configuration file:
{ "mcpServers": { "bookme": { "serverUrl": "https://bookme.brandid.app/mcp" } } } - Refresh the servers and sign in to bookme when asked.
Windsurf allows 100 tools in total across all servers; bookme has at most 78.
Gemini CLI
In a terminal with the Gemini CLI, on a computer with a browser.
- Run this command:
gemini mcp add --transport http bookme https://bookme.brandid.app/mcp - Then run
/mcp auth bookmein Gemini CLI and sign in to bookme in the browser.
Other apps
Any app that connects to remote MCP servers with sign-in (OAuth).
- Add the address above as a remote MCP server (Streamable HTTP). The app finds the sign-in by itself.
- Sign in to bookme when asked and choose what the app may do. You always sign in on bookme's own page; the app never sees your password.
Apps bookme does not know are marked "Not verified": only allow one you started yourself. Abilities lists what an app can do, and its "For developers" part has the technical details.
Choose what it may do
On the consent screen pick View only, View and manage or Custom (area by area). Unverified apps start at View only. You can change it any time in bookme under MCP (AI Assistants), Apps; giving more access asks for a fresh sign-in code.
How changes stay safe
Changes to your own settings: profile, event types, hours, days off, booking questions, automated emails and notes. Listed in Activity, and most can be undone there for 30 days.
Changes that reach other people or cannot be undone: cancelling or moving a meeting, recording an outcome that emails the invitee, removing a guest, adding a few people to a webinar, changing who hosts a team event, answering a team invitation, deleting an unused event type. The AI must show you exactly what will happen and wait for your yes.
High impact: inviting someone new, emailing a whole webinar list, cancelling several meetings, automations that send data or links outside bookme, changing the contact links on your profile, and more than 10 people-affecting changes in one hour. You approve or reject each one in MCP (AI Assistants), Approvals; nothing happens until you do.
What an AI app can never do
- Payments, plans, billing, refunds or payouts
- Your password, email or sign-in methods
- Connecting or disconnecting calendars, video and other apps
- Changing your organization, its members or billing
- Its own access: only you change what an AI app may do
- Deleting your account
Limits keep a confused or manipulated assistant in check: about 90 requests a minute, 20 changes a minute, and a smaller budget for changes that affect other people. Paid meetings are never cancelled by an AI app, and it never issues refunds.
Your control panel
In bookme, open MCP (AI Assistants) in the sidebar. A badge shows how many requests wait for you, and a switch at the top pauses every AI app at once (connections are kept). Nine tabs:
- Overview: today in numbers, what waits for you, what is on its way, and the latest requests.
- Apps: what each app may do, change its access (more access asks for a code), disconnect one or every app, and the steps to connect nine apps.
- Approvals: the exact request (who gets which email, which links) with Approve and Reject, why it waits, and what became of the ones you decided, with what an approved one gave back. Requests expire after 24 hours.
- Conversations: each app's requests grouped into sessions, read like a transcript, with Undo. bookme never sees your chat with the app.
- Activity: every request an AI app made, kept for 12 months, filtered by changes, refusals or app, with Undo on changes to your own settings for 30 days.
- Outbox: emails and invitations an AI app started that are still going out, each with its stop.
- Abilities: everything an app can do, area by area, when it asks first or waits for you, and what it can never do.
- Limits: when changes that reach people wait for your approval, the approval emails, and today's counts.
- Help: answers to common questions.
Security and privacy
- You sign in on bookme with OAuth 2.1 and PKCE. The AI app never sees your password.
- Access keys last 15 minutes and refresh keys change on every use. A used key that comes back stops the connection.
- A connection lasts up to 90 days and ends after 30 days without use. Changing your password disconnects every AI app.
- Text that invitees, guests or registrants typed is marked as coming from outside your account, so the assistant treats it as information, never as instructions.
- An AI app sees only what its tools return (for example a meeting's time, invitee name and email, and notes). What you share in a chat is then also covered by that AI provider's own terms and privacy policy. See our Privacy Policy.
Did not connect an app you see in MCP (AI Assistants)? Disconnect it in Apps, change your password and write to [email protected].
Tool reference
78 tools in 10 areas. The badge says what happens when the assistant uses one.
Account and organization
get_Your profile, timezone, limits, connected apps; your organization (never billing)Read onlyaccount / get_ organization check_Status of a request waiting for your approvalRead onlyapproval update_Name, bio, tagline, time zone, booking page design (contact links: your approval)Right awayprofile
Event types
list_Event types, booking links and website embed codeRead onlyevent_ types / get_ event_ type / get_ share_ links create_New event type, optionally with its own weekly hoursRight awayevent_ type update_Title, duration, location, buffers, notice, caps, custom link and more (never prices)Right awayevent_ type duplicate_Copy, pause or activateRight awayevent_ type / set_ event_ type_ status delete_Drafts and paused event types that were never bookedAsks you firstevent_ type
Availability
list_Weekly hours and days offRead onlyavailability_ schedules / list_ date_ overrides find_Open times exactly as your booking page offers themRead onlyopen_ times create / update / delete_Weekly hoursRight awayavailability_ schedule set_Days off and special hours (never cancels meetings)Right awaydate_ override / remove_ date_ override
Meetings
list_Meetings, details and the follow-ups an outcome would sendRead onlymeetings / get_ meeting / preview_ follow_ up_ emails list_People you meet with their history; recordings (watched in bookme)Read onlycontacts / list_ recordings list_Recurring series and each session with its payment state (booking, cancelling and refunds stay in bookme). Shown when your account has recurring bookingsRead onlybooking_ series / get_ booking_ series list_Session packages your clients bought and the credits they have left. Shown when your account sells packagesRead onlyclient_ credits update_Private or shared host noteRight awaymeeting_ note cancel_One meeting you host (paid meetings are cancelled in bookme)Asks you firstmeeting / reschedule_ meeting record_Met, no-show, host missed, needs a new time; undo a wrong outcomeAsks you firstmeeting_ outcome / clear_ meeting_ outcome remove_Take a guest off a meetingAsks you firstmeeting_ guest add_Invite a new guest; cancel several meetings at onceYour approvalmeeting_ guest / cancel_ meetings
AI meeting notes
list_Your notes, newest first, with what your plan has left this month; one meeting's notes in full (summary, action items, decisions); search across them. Never transcripts or recordingsRead onlymeeting_ notes / get_ meeting_ notes / search_ meeting_ notes list_Open action items (with every copy when two tools caught one); everything your notes say about one person you metRead onlyaction_ items / get_ person_ notes update_Tick an action item off, or back again. Nobody is toldRight awayaction_ item set_AI notes on or off for an event type, emailing the notes to invitees, style, language and the notes bot. Only bookings made after the change; turning notes, the bot or the email on asks you firstAsks you firstevent_ ai_ notes set_Turn AI notes off for one meeting (its notes are deleted, so it asks you first), or back on before it starts when you turned them offAsks you firstmeeting_ notetaker
Webinars
list_Webinars, emails and registrantsRead onlywebinars / get_ webinar / list_ webinar_ registrants create_Draft webinar and draft emails; nothing is sentRight awaywebinar / save_ webinar_ email (manual) send_Test email to you onlyRight awaywebinar_ test_ email manage_Stop a send or copy an email as a draft (deleting one asks you first)Right awaywebinar_ email update_Details right away; moving a webinar people signed up for and changing its list ask first (over 10 people: your approval)Asks you firstwebinar / add_ webinar_ attendees / remove_ webinar_ attendee send_Anything that emails your listYour approvalwebinar_ email / save_ webinar_ email (automatic) / cancel_ webinar
Team events
list_Team events and co-hostsRead onlyteam_ events / get_ team_ roster / list_ team_ invitations set_Which of your schedules counts on someone else's team eventRight awaymy_ team_ schedule update_Organizer, parts, hours; accept or decline invitations; resend an invite (cancelling one is right away)Asks you firstteam_ event / respond_ to_ team_ invitation / manage_ team_ email_ invite invite_Co-hosts on your eventsYour approvalteam_ host / remove_ team_ host
Booking questions and automated emails
list_Forms, automations and ready-made templatesRead onlybooking_ questions / list_ automated_ emails / list_ automated_ email_ templates create / update / attach / delete_Questions people answer when they bookRight awaybooking_ questions create / update / delete_Emails to you and your invitees (links outside bookme or webhooks: your approval)Right awayautomated_ email, set_ automated_ email_ status, create_ automated_ email_ from_ template
Reports
get_Counts, no-show rate, busiest days and hours, top event typesRead onlymeeting_ report
Questions
The assistant says a change is waiting for my approval. Where do I approve it?
In bookme, open MCP (AI Assistants), then Approvals. The request shows everything it will do and why it waits. Approve runs it once; Reject drops it. It expires after 24 hours.
Why did the assistant ask me before cancelling a meeting?
Anything that emails or affects other people takes two steps: the assistant first gets a description of exactly what will happen, shows it to you and only then confirms. The confirmation works once, for those exact details, for 10 minutes.
Can I undo something the assistant did?
Changes to your own settings (event types, hours, days off, questions, automated emails, notes) have Undo in Activity and in Conversations for 30 days. Changes that already reached people, like a sent email or a cancelled meeting, cannot be taken back automatically; emails and invitations still going out can be stopped in Outbox.
How do I stop an AI app right now?
Turn off the switch at the top of MCP (AI Assistants), or click Disconnect on that app in Apps. Both take effect on its next request.
The app asks me to sign in to bookme again.
The connection ended: it is older than 90 days, was unused for 30 days, your password changed, or it was disconnected. Sign in again to reconnect.
Can an AI app see my payments or change my prices?
No. Payments, prices, plans, billing, refunds and payouts are not available to AI apps at all.
For developers
- Endpoint:
POST https://bookme.brandid.app/mcp, Streamable HTTP with JSON responses (stateless; GET and DELETE answer 405). Protocol versions 2025-11-25, 2025-06-18 and 2025-03-26. - Auth: OAuth 2.1 bearer tokens. Discovery at
/.well-known/oauth-protected-resource/mcpand/.well-known/oauth-authorization-server. Client ID metadata documents and dynamic client registration are supported (public clients, PKCE S256, resource indicator = the server address). - Scopes:
reports:read,organization:read, and read and write scopes foraccount,events,availability,meetings,webinars,teams,forms,workflows. A missing scope answers 403 with a step-up challenge. - Two-step changes: the first call returns
status: "needs_confirmation"and aconfirmation_token; repeat the same arguments with the token after the user agrees. - Approvals: held requests return
status: "pending_approval"and anapproval_idforcheck_approval. - Every change tool takes
preview(describe, change nothing) andidempotency_key. Tools carry readOnlyHint, destructiveHint and openWorldHint annotations. - Prompts: 7 ready-made commands (
prompts/list): daily briefing, weekly review, set up an event type, record outcomes, follow up no-shows, plan time off, prepare a webinar.
Questions or a security report: [email protected].