Developer docs: AI assistants (MCP)
Connect an AI assistant (MCP)
Ask Claude, Cursor or another AI app about your calls, leads and appointments in plain words, and let it place calls or book appointments after you approve each one. It works through the Model Context Protocol (MCP) and your BookifyCall API key.
Before you start
- The MCP server is part ofthe Enterprise plan, and we turn it on per account. Ask us to switch it on for yours. Once it’s on, Settings → API keys shows a “Connect an AI assistant” panel.
- You need to be an owner or admin of the account, because you’ll create an API key.
- Server address:
https://bookifycall.com/api/v1/mcp
Quickest: sign in with BookifyCall
Claude (web and desktop), Claude Code and other apps that support MCP sign-in can connect without a key:
- In Claude open Settings → Connectors → Add custom connector. Name it BookifyCall and paste
https://bookifycall.com/api/v1/mcp. Leave the advanced settings empty (Claude uses its published identity), then Add. - Press Connect. A BookifyCall page opens: sign in, choose what the app may do (reading is always included; booking appointments is optional), and press Allow, then confirm with your password.
- Back in Claude, BookifyCall’s tools appear in the tools menu. In Claude Code use
claude mcp add --transport http bookifycall https://bookifycall.com/api/v1/mcpand run/mcpto sign in.
The connection shows in Settings → API keys as “Claude (connected app)”; revoke it there to disconnect. Only owners and admins can connect apps.
Or use an API key: 1. Create a key for the assistant
In Settings → API keys, create a key named after the app, for example “Claude Desktop”. Give it only what the assistant needs:
- Look things up only:
calls:read,leads:read,appointments:read,agents:read,numbers:read. Addrecordings:readfor recording links andcompliance:readfor texting registration and number porting status. - Place and end calls, add to the do-not-call list:
calls:write. - Schedule calls:
scheduled_calls:write. - Book, move and cancel appointments:
appointments:write. - Change your agents’ answers, business hours, services and transfer contacts:
agents:write, once we’ve switched agent editing on for your account.
The key is shown once. Keep it like a password: anyone with it can act as your account within its scopes. Start read-only; add write scopes when you’re ready (about keys and scopes).
2. Add BookifyCall to your app
Pick your app and replace YOUR_API_KEY with the key.
claude mcp add --transport http bookifycall https://bookifycall.com/api/v1/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Claude Desktop, step by step
- Install Node.js (the LTS version). Claude Desktop uses it to run the small
mcp-remotebridge that sends your key. - In Claude Desktop open Settings → Developer → Edit Config. This opens
claude_desktop_config.json(Windows:%APPDATA%\Claude, Mac:~/Library/Application Support/Claude). - Paste the Claude Desktop setup above. If the file already has
mcpServers, add only thebookifycallentry inside it. Keep the wordBearerand the space before your key. - Quit Claude Desktop completely (Windows: right-click the tray icon → Quit; Mac: Cmd+Q) and open it again. Closing the window is not enough.
- In a new chat, open the tools menu: you should see BookifyCall with its tools, all starting
bookifycall_.
3. Try it
- “Who am I connected as in BookifyCall?”
- “Show my last 10 calls and what each caller wanted.”
- “What appointments do I have this week?”
- “Which leads from yesterday haven’t been called back?”
- “Tell BookifyCall support my number stopped taking calls this morning.”
What it can and can’t do
The assistant can read your calls, transcripts and AI summaries, recordings, leads, appointments and free slots, agents, numbers, usage and insights, scheduled calls, your do-not-call list and webhook subscriptions. With the write scopes it can place, schedule and end calls, add numbers to the do-not-call list, and book, move and cancel appointments. With any key it can contact BookifyCall support for you: the ticket shows up in Help → Support and replies come to your email.
With agent editing switched on and agents:write, it can add an answer to an agent’s knowledge base, change business hours, and replace the services list or transfer contacts. It can’t create or delete agents, change their instructions or voice, change phone numbers or webhooks, or take a number off the do-not-call list. Those stay in the app.
Access, limits and disconnecting
- The assistant has exactly the key’s scopes and nothing more.
- Its requests count toward the key’s rate limit, like any API request.
- To disconnect, revoke the key in Settings → API keys. It stops working at once.
If it doesn’t work
- No BookifyCall tools in the app: check the config file is valid JSON, then fully quit and reopen the app. In Claude Desktop, Settings → Developer shows the server’s error.
- “Send a BookifyCall API key…” (401): the key is wrong or revoked, or
Beareris missing in front of it. - “The MCP server isn’t turned on for this account yet”: ask us to switch it on.
- “Calls to numbers in this country aren’t enabled on BookifyCall” (
CALL_044): only US and Canada numbers can be called unless we switch another country on. Nothing was dialled and no minutes were used. Ask support with the country and what the calls are for. - “Your plan doesn’t include API access”: the MCP server needsthe Enterprise plan.
- “This key is for Zapier and Make only”: create a separate API key for the assistant.
- “API key is missing a required scope”: create a key with the scope that tool needs (listed above).
npxnot found: install Node.js and restart the app.