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/mcpBefore 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)
- Open Settings › Connectors and choose Add custom connector. Once Mookee is listed in the connector directory, you can pick it there instead.
- Name it Mookee and paste the server URL. Leave the OAuth client fields empty: Claude registers itself.
- Choose Connect. A Mookee page opens: sign in, check which app is asking, then choose Allow.
- In a conversation, turn the Mookee connector on from the tools menu.
https://mcp.app.mookee.io/mcpOn a Claude Team or Enterprise plan, an owner may need to add the connector for the organization first.
Claude Code
- Run the command below in a terminal.
- 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/mcpOther clients
- Add a remote MCP server (Streamable HTTP) with the server URL and no Authorization header.
- 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/mcpWhat 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.
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.
- 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.
https://mcp.app.mookee.io/mcp?toolsets=only,audience,campaignsSupport
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.