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.

Server addresshttps://bookme.brandid.app/mcp

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

  1. On claude.ai or in the Claude desktop app, open Customize, then Connectors.
  2. Choose Add custom connector, name it bookme and paste the address above. Keep the sign-in options Claude picks and press Add.
  3. 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.
  4. 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.

  1. 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).
  2. Create an app: name it bookme, paste the address above, and keep the sign-in on OAuth.
  3. Sign in to bookme when asked, choose what ChatGPT may do, and press Allow.
  4. 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.

  1. Run this command:
    claude mcp add --transport http bookme https://bookme.brandid.app/mcp
  2. Then run /mcp in 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.

  1. Run these commands (the second one opens the sign-in):
    codex mcp add bookme --url https://bookme.brandid.app/mcp
    codex mcp login bookme
  2. Or add it to ~/.codex/config.toml yourself:
    [mcp_servers.bookme]
    url = "https://bookme.brandid.app/mcp"

Cursor

Cursor on your computer.

  1. 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" }
      }
    }
  2. 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.

  1. 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" }
      }
    }
  2. 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.

  1. 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" }
      }
    }
  2. 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.

  1. Run this command:
    gemini mcp add --transport http bookme https://bookme.brandid.app/mcp
  2. Then run /mcp auth bookme in Gemini CLI and sign in to bookme in the browser.

Other apps

Any app that connects to remote MCP servers with sign-in (OAuth).

  1. Add the address above as a remote MCP server (Streamable HTTP). The app finds the sign-in by itself.
  2. 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.

AreaViewChange
AccountView: Profile, timezone, plan limits and which calendars and apps are connectedChange: Name, bio, time zone, booking page design (contact links: your approval)
Event typesView: Event types, booking links and embed codeChange: Create, edit, duplicate, pause, delete unused drafts
AvailabilityView: Schedules, days off and open timesChange: Weekly hours and date overrides
MeetingsView: Meetings, notes, follow-up previews, contacts, recurring series, package credits, recordings listChange: Notes and outcomes, cancel, reschedule, guests
WebinarsView: Webinars, registrants, email resultsChange: Create and edit, repeat, add people, draft emails
Team eventsView: Team events, co-hosts, invitationsChange: Co-hosts, organizer, parts, invitations
OrganizationView: Members, roles, team pages, managed events (never billing)Change: Not available
Booking questionsView: Booking question formsChange: Create, edit, attach
Automated emailsView: Automated emailsChange: Create, edit, turn on or off
ReportsView: Meetings, no-shows, busiest times, top event typesChange: Not available

How changes stay safe

Right away

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.

Asks you first

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.

Your approval in bookme

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.

Open MCP (AI Assistants)

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_account / get_organizationYour profile, timezone, limits, connected apps; your organization (never billing)Read only
  • check_approvalStatus of a request waiting for your approvalRead only
  • update_profileName, bio, tagline, time zone, booking page design (contact links: your approval)Right away

Event types

  • list_event_types / get_event_type / get_share_linksEvent types, booking links and website embed codeRead only
  • create_event_typeNew event type, optionally with its own weekly hoursRight away
  • update_event_typeTitle, duration, location, buffers, notice, caps, custom link and more (never prices)Right away
  • duplicate_event_type / set_event_type_statusCopy, pause or activateRight away
  • delete_event_typeDrafts and paused event types that were never bookedAsks you first

Availability

  • list_availability_schedules / list_date_overridesWeekly hours and days offRead only
  • find_open_timesOpen times exactly as your booking page offers themRead only
  • create / update / delete_availability_scheduleWeekly hoursRight away
  • set_date_override / remove_date_overrideDays off and special hours (never cancels meetings)Right away

Meetings

  • list_meetings / get_meeting / preview_follow_up_emailsMeetings, details and the follow-ups an outcome would sendRead only
  • list_contacts / list_recordingsPeople you meet with their history; recordings (watched in bookme)Read only
  • list_booking_series / get_booking_seriesRecurring series and each session with its payment state (booking, cancelling and refunds stay in bookme). Shown when your account has recurring bookingsRead only
  • list_client_creditsSession packages your clients bought and the credits they have left. Shown when your account sells packagesRead only
  • update_meeting_notePrivate or shared host noteRight away
  • cancel_meeting / reschedule_meetingOne meeting you host (paid meetings are cancelled in bookme)Asks you first
  • record_meeting_outcome / clear_meeting_outcomeMet, no-show, host missed, needs a new time; undo a wrong outcomeAsks you first
  • remove_meeting_guestTake a guest off a meetingAsks you first
  • add_meeting_guest / cancel_meetingsInvite a new guest; cancel several meetings at onceYour approval

AI meeting notes

  • list_meeting_notes / get_meeting_notes / search_meeting_notesYour 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 only
  • list_action_items / get_person_notesOpen action items (with every copy when two tools caught one); everything your notes say about one person you metRead only
  • update_action_itemTick an action item off, or back again. Nobody is toldRight away
  • set_event_ai_notesAI 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 first
  • set_meeting_notetakerTurn 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 first

Webinars

  • list_webinars / get_webinar / list_webinar_registrantsWebinars, emails and registrantsRead only
  • create_webinar / save_webinar_email (manual)Draft webinar and draft emails; nothing is sentRight away
  • send_webinar_test_emailTest email to you onlyRight away
  • manage_webinar_emailStop a send or copy an email as a draft (deleting one asks you first)Right away
  • update_webinar / add_webinar_attendees / remove_webinar_attendeeDetails right away; moving a webinar people signed up for and changing its list ask first (over 10 people: your approval)Asks you first
  • send_webinar_email / save_webinar_email (automatic) / cancel_webinarAnything that emails your listYour approval

Team events

  • list_team_events / get_team_roster / list_team_invitationsTeam events and co-hostsRead only
  • set_my_team_scheduleWhich of your schedules counts on someone else's team eventRight away
  • update_team_event / respond_to_team_invitation / manage_team_email_inviteOrganizer, parts, hours; accept or decline invitations; resend an invite (cancelling one is right away)Asks you first
  • invite_team_host / remove_team_hostCo-hosts on your eventsYour approval

Booking questions and automated emails

  • list_booking_questions / list_automated_emails / list_automated_email_templatesForms, automations and ready-made templatesRead only
  • create / update / attach / delete_booking_questionsQuestions people answer when they bookRight away
  • create / update / delete_automated_email, set_automated_email_status, create_automated_email_from_templateEmails to you and your invitees (links outside bookme or webhooks: your approval)Right away

Reports

  • get_meeting_reportCounts, no-show rate, busiest days and hours, top event typesRead only

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/mcp and /.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 for account, 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 a confirmation_token; repeat the same arguments with the token after the user agrees.
  • Approvals: held requests return status: "pending_approval" and an approval_id for check_approval.
  • Every change tool takes preview (describe, change nothing) and idempotency_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].