CallBookerAI assistants (MCP) API docs

Use CallBooker from Claude, Cursor and other AI assistants

Connect CallBooker to your AI assistant and just ask: “Add Sarah from this email and have my agent call her”, “How many meetings did we book this week?” or “Who's interested but hasn't booked yet?”

CallBooker speaks MCP (Model Context Protocol) at https://callbooker.com/mcp. You sign in with an API key; calls use that key's agent, and your minutes and calling agreement apply as usual. Your assistant asks you before anything that calls someone.

Claude Code

Terminal
claude mcp add --transport http callbooker https://callbooker.com/mcp \
  --header "Authorization: Bearer cb_live_YOUR_KEY"

Cursor

Settings → MCP → Add new server, or add this to ~/.cursor/mcp.json:

mcp.json
{
  "mcpServers": {
    "callbooker": {
      "url": "https://callbooker.com/mcp",
      "headers": { "Authorization": "Bearer cb_live_YOUR_KEY" }
    }
  }
}

VS Code (Copilot) and other MCP clients

Add an HTTP (“streamable HTTP”) server with the URL above and the header Authorization: Bearer cb_live_YOUR_KEY.

.vscode/mcp.json
{
  "servers": {
    "callbooker": {
      "type": "http",
      "url": "https://callbooker.com/mcp",
      "headers": { "Authorization": "Bearer cb_live_YOUR_KEY" }
    }
  }
}

Claude and ChatGPT apps

A one-click “Connect CallBooker” (sign in, no key to paste) is coming soon to the Claude and ChatGPT apps.

What your assistant can do

get_accountPlan, minutes left, and whether your agent is ready to call
add_leadAdd a lead and have your agent call it within seconds (or just add it)
list_leadsFind leads by status, e.g. everyone interested or waiting for a callback
get_leadA lead's notes, answers and upcoming meeting
call_leadCall a lead again
list_calls / get_callCall results, notes and transcripts
list_meetingsMeetings booked, by date

Everything your assistant does shows up in the request log on the Lead API page.

Things to ask

  • “Add Sarah Johnson, +1 415 555 0142, she asked about pricing for 10 seats, and call her now.”
  • “Who's waiting for a callback? Call them back.”
  • “Summarize yesterday's calls: who's interested and why.”
  • “Which meetings did the agent book this week?”
  • “How many minutes do I have left this month?”

Security and limits

  • Your assistant uses your API key, so it can only do what that key can do, and calls use that key's agent.
  • Keep the key private: treat it like a password and revoke it from the Lead API page if it leaks.
  • The same rules as the API apply: your plan's minutes, rate limits, the calling agreement, and do-not-call blocks.
  • The MCP server is available on the Starter plan and above, like the Lead API.

Troubleshooting

  • Unauthorized: check the key is copied in full, including the cb_live_ prefix, and hasn't been revoked.
  • “Plan required”: the Lead API and MCP need the Starter plan or higher.
  • Calls don't start: make sure your agent has a phone number and you have minutes left. The API docs list every error.