Developers

Mookee MCP server

Connect Claude or another AI assistant to Mookee. It can look up contacts and conversations, explain campaign results and set things up in your workspaces, with exactly the access you have in the dashboard. It asks before anything that sends messages, moves money or deletes.

Server URL

https://mcp.app.mookee.io/mcp

Before you connect

  • A Mookee account that is a member of at least one workspace. You sign in the way you usually do (email and password, Google or Apple), with multi-factor authentication if your workspace requires it.
  • Any Mookee plan, including a new workspace in sandbox mode. What the assistant can do is what your role and plan allow in the dashboard.
  • An AI client that supports remote MCP servers with OAuth: Claude (web, desktop and mobile), Claude Code, Cursor, ChatGPT and others.

Connect

Claude (claude.ai, desktop and mobile)

  1. Open Settings › Connectors and choose Add custom connector. Once Mookee is listed in the connector directory, you can pick it there instead.
  2. Name it Mookee and paste the server URL. Leave the OAuth client fields empty: Claude registers itself.
  3. Choose Connect. A Mookee page opens: sign in, check which app is asking, then choose Allow.
  4. In a conversation, turn the Mookee connector on from the tools menu.
https://mcp.app.mookee.io/mcp

On a Claude Team or Enterprise plan, an owner may need to add the connector for the organization first.

Claude Code

  1. Run the command below in a terminal.
  2. In Claude Code, run /mcp, choose mookee and sign in in the browser that opens.
claude mcp add --transport http mookee https://mcp.app.mookee.io/mcp

Other clients

  1. Add a remote MCP server (Streamable HTTP) with the server URL and no Authorization header.
  2. The client discovers the sign-in from the server's first answer and opens the Mookee page in your browser.
https://mcp.app.mookee.io/mcp

What it can do

About 165 tools cover the areas of the dashboard. Each one calls the same Mookee API the dashboard uses, as you.

Workspaces
Workspaces, onboarding status, account, custom domain.
Senders
Phone numbers, WhatsApp activation, limits and status.
Audience
Contacts, tags, segments, imports and exports.
Inbox
Conversations, sending one message, needs-reply, suggested replies, calls, parked messages.
Campaigns
Campaigns, message templates, media, cost and duration estimates, scheduling, results.
Opt-in pages
Subscription forms, channel trees and their funnels.
AI agent
Agent switches, main prompt and its versions, knowledge base, automations, detectors, test chat.
Analytics
Dashboard statistics, campaign performance, attribution, workspace search.
Shop
Products, tiers, music releases, payment links, orders and tickets.
Settings
Workspace settings, team and roles, email domain and warmup, webhooks, plan and credits.
Integrations
Data sources such as Stripe, Tito or Delight.

Some things stay in the dashboard on purpose: paying and checkout, buying phone numbers, secrets such as API keys and integration credentials, Meta's WhatsApp signup, and audio uploads. The assistant tells you when a task needs one of them.

Example prompts

  • “Which of my campaigns last month had the best click rate, and what did they have in common?”
  • “Show me the conversations that still need a reply and suggest an answer for each.”
  • “How many contacts tagged VIP can I reach on WhatsApp? Create a segment with them.”
  • “Estimate the cost and duration of sending a reminder to everyone with a ticket for Saturday's show.”
  • “Create a subscription form for our festival newsletter, in English and French.”
  • “Why did my last campaign stop before reaching everyone?”

Permissions and confirmations

  • Every call runs as you. A workspace you are not a member of, or an action your role or plan does not allow, is refused exactly as in the dashboard.
  • Actions that send messages to real people, move money or cannot be undone change nothing the first time: the tool answers with what would happen, and acts only when the assistant calls it again after you said yes. This covers sending a message, starting or scheduling a campaign, refunding or cancelling an order, and every delete.
  • Read-only tools are marked read-only, and every tool that deletes data is marked destructive, so your client can ask you before using it.
  • A change made through the assistant is a change made by you, like a save in the dashboard. If a teammate has the same item open, the assistant takes the edit over and tells you.

Data and privacy

  • The MCP server has no database. It keeps only what sign-in needs, on Mookee's own servers: the registration of your AI client (removed after 90 days without use), pending sign-ins (10 minutes) and one-time codes (5 minutes).
  • Access tokens last one hour and refresh tokens 30 days, and neither outlives your Mookee session. They carry that session encrypted (AES-256-GCM); the server keeps no copy of it.
  • The server never sees your conversation with the assistant. It receives only the arguments of each tool call and does not log them. Request logs (time, path, status, and your user id when a call fails) are kept for 10 days.
  • What you read or change through the server is your Mookee data, under the Mookee privacy policy, and Mookee records changes as it does for the dashboard. What your AI provider does with tool results is governed by its own terms.

Read the privacy policy

Disconnect

  • Remove or disconnect the Mookee connector in your AI client. Nothing new can be issued without signing in again, and the last access token stops working within an hour.
  • When your Mookee session expires, every connection that uses it stops, and you sign in again to reconnect.
  • To cut a connection off immediately, email support: we delete the client's registration, which revokes its refresh tokens.

Troubleshooting

The client keeps asking me to sign in
Your Mookee session has expired or was ended. Reconnect and sign in again; the connector then works with the new session.
A tool says I'm not allowed
The action needs a role or plan you don't have in that workspace, exactly as in the dashboard. A workspace owner can change your role in Settings.
Nothing was sent
Sending tools wait for your agreement: the first call only describes what would happen. Say yes in the conversation and the assistant calls it again.
My client has a limit on the number of tools
Add a toolsets list to the URL to serve only some areas, for example the one below. Areas: workspace, senders, audience, inbox, campaigns, optin, agent, analytics, agent-advanced, calls, delayed, shop, settings, integrations.
https://mcp.app.mookee.io/mcp?toolsets=only,audience,campaigns
Something else is unclear
Ask the assistant to read the Mookee guide for that area: it explains defaults, what each status means, and the usual causes of a problem. Or contact support.

Support

Email us with what you asked the assistant and what it answered, or use the support chat in your dashboard. Questions about privacy: contact@mookee.io.