How to Connect KaiCalls to Claude, ChatGPT, Grok, or Manus
Link your KaiCalls account to an AI assistant so you can ask about your business in plain language — “How many leads came in this week?”, “Read me the latest voicemail”, “Call this lead back.”
What it does
Hook KaiCalls up to the AI assistant you already use — ChatGPT, Claude, Grok, and others — and you can just ask it about your business. “Did I miss anything overnight?” “Call that lead back.” “We’re closed Sundays now.” It reads your calls, leads, voicemails and texts, and can make changes for you. You stay in control: it signs in with your own KaiCalls login, only reaches the one business you approve, and you can disconnect it any time. (If you see this called an “MCP connector”, that’s the technical name for the same thing.)
What to say once you’re connected
You don’t need special phrasing — ask the way you’d ask a person. Below are the jobs owners use this for most, with sentences you can copy as-is. Each one does real work on your account: reading your calls, changing what Kai says, placing calls, or running your voice tests.
Catch up on what you missed
The morning question, without opening the dashboard or listening to anything.
- “Did I miss anything overnight?” — Reads back last night’s calls, voicemails, and texts in one answer.
- “Summarize the calls Kai handled this week and how many turned into leads.” — Totals for the week, with the calls that produced a lead called out.
Fix how Kai talks
When a caller got the wrong answer and you want it never to happen again.
- “Kai keeps flubbing the pricing question. Pull a recent call and fix it.” — Finds the call, reads the transcript, and updates the agent so it answers right.
- “We’re closed Sundays now.” — Updates your hours so Kai stops offering Sunday appointments.
- “Add our $149 drain-cleaning special so Kai quotes it correctly.” — Adds the offer to what Kai knows, so it can quote the price on a call.
Chase leads and follow up
Have Kai place the calls and send the texts you would otherwise do yourself.
- “Call the three leads from yesterday who never booked.” — Kai places the calls and reports back how each one went.
- “Text the customer from the 2pm call our address and a booking link.” — Sends the text from your business number.
Test before you trust it
Run the voice tests against your own line — the same regression pack, on demand, in a sentence.
- “Test that the after-hours flow still works before I go to bed.” — Runs your saved call scenarios and tells you which ones passed.
- “I just changed the greeting — re-run the tests and tell me if I broke anything.” — Re-runs the scenarios against the current setup and reports failures.
See what changed, and undo it
Every change is recorded, so "put it back how it was" is a real instruction.
- “What changed on my agent last week, and who changed it?” — Lists the changes with timestamps and where each one came from.
- “Undo whatever changed the greeting last Tuesday.” — Rolls that change back and confirms what the greeting says now.
Check usage and billing
Answer "am I about to get a surprise?" without a support ticket.
- “Am I going to blow past my plan this month?” — Compares answered calls against your allowance and flags a better-fitting plan.
- “Why did my bill change?” — Walks through the plan and add-on changes on your account.
Check nothing is quietly broken
Catch a dead calendar or CRM connection before a customer finds it for you.
- “Is anything broken today?” — Surfaces failed bookings, sync errors, and tool timeouts from your calls.
- “Is my number actually answering right now?” — Confirms which numbers are live and attached to which agent.
The quickest way to connect
Not every assistant is equally easy, so start with whichever of these you already use. The first two take one click — the connector is filled in for you and all you do is approve it and sign in.
- ChatGPT (one click) — Open the KaiCalls app and press Connect, then sign in. Nothing to paste.
- Cursor (one click) — Opens Cursor with the connector already filled in — approve it and sign in.
- Claude Code (one command) — Run the command, then authenticate with /mcp inside Claude Code. Run: claude mcp add --transport http kaicalls https://www.kaicalls.com/api/mcp
- Claude (paste a url) — Opens Claude’s connector settings — press “Add custom connector”, paste the KaiCalls URL, and sign in. Note: On a Team or Enterprise plan, only a workspace owner can add a connector. If you don’t see the option, that’s why — send the request to whoever owns your Claude workspace.
- Gemini (paste a url) — In Settings & help → Connected Apps, paste the KaiCalls URL under “Add a custom app link”, then sign in. Note: Custom connectors live in Gemini Spark, on personal Google accounts and on the web first — a Workspace account may not show the option.
- Grok (paste a url) — In grok.com/connectors, add a Custom connector and paste the KaiCalls URL.
Every other assistant
The rest work the same way — you paste one URL into your assistant’s connector settings, sign in with your normal KaiCalls account, and approve what it asks for. The URL is always: https://www.kaicalls.com/api/mcp
- Open your assistant’s connector or integration settings.
- Paste the KaiCalls connector URL: https://www.kaicalls.com/api/mcp
- Sign in with your normal KaiCalls account when prompted.
- Approve the permissions it asks for. If you belong to more than one business, you’ll pick which one to connect — the assistant only reaches that one business.
- You’re connected. Try “Did I miss anything overnight?” to confirm.
- Codex (edit a config file) — Add KaiCalls to ~/.codex/config.toml, then let it sign in on first use. Note: Support for remote connectors varies by Codex version; older builds need the mcp-remote bridge shown in the setup guide.
- Manus (edit a config file) — In Settings → Integrations → Custom MCP Servers, add the KaiCalls URL with an API key as the bearer token. Note: Manus needs a KaiCalls API key rather than a normal sign-in, so create one in Settings → API Keys first. If you’d rather not manage a key, use one of the sign-in options above.
- VS Code & GitHub Copilot (edit a config file) — Add KaiCalls to .vscode/mcp.json, then approve the sign-in on first use.
Staying in control
- The assistant connects through your KaiCalls login and only sees the business you approved.
- Most actions are read-only (looking things up). Placing calls and any configuration changes are separate, clearly-scoped permissions.
- Sensitive changes (like updating an agent’s prompt or settings) require an explicit confirmation or your approval in the dashboard before they take effect.
- You can revoke a connection any time from your KaiCalls account.
Prefer to talk instead of type?
Claude and ChatGPT are one way to manage your account hands-free — the other is your own phone. Call your KaiCalls number from a registered phone and Kai answers in admin mode, so you can check your leads, change your greeting, update your hours, and more, just by asking out loud. It is the same set of changes, over the phone instead of by chat. See the “How the admin secretary works” help page (/help/admin-secretary) for the full list.
For developers
Building your own integration or connecting a marketplace? KaiCalls also exposes a REST API and the full MCP tool catalog, with OAuth 2.1 + PKCE. See the AI connectors guide (/docs/api/connectors) for per-client setup — including Cursor, VS Code, Windsurf, and the Gemini CLI — and the API reference for tool schemas, scopes, and the on-behalf update broker.