MCP Server for Managing WhatsApp Business Platform Chats from AI Assistants like Meta Muse and Claude
Stay in the AI assistant you already use. Connect it to TimelinesAI to read your WhatsApp Business Platform chats, reply to customers, send approved templates, and assign and label chats for your team.
The TimelinesAI MCP server works with any AI assistant that supports remote MCP servers with OAuth sign-in. There’s no software to install, no server to manage, and no password to share. The assistant can only do what your TimelinesAI role allows.
What the connector can do
- Read chats, message history and message status across your WhatsApp Business Platform numbers
- Reply with free text while the customer’s 24-hour window is open
- Send Meta-approved templates, and start new chats with a template
- Assign, unassign, open and close chats, and add or remove labels
- React to messages, and see your team members and templates
What you need
- A TimelinesAI account. New accounts start with a 10-day free trial, no credit card required.
- At least one WhatsApp Business Platform (Cloud API) number connected to your workspace. Learn more about WhatsApp Business API on TimelinesAI.
- At least one approved template, if you want the assistant to start new chats or message customers outside the 24-hour window.
How to set up
Step 1: Add the connector.
In your AI assistant, add a new connector (or custom MCP server) and paste
https://mcp.services.timelines.ai/mcp/waba.Step 2: Sign in with TimelinesAI.
The assistant opens the TimelinesAI login page. Sign in, or create an account.
Step 3: Approve access.
Review the permissions on the “Authorize timelines-mcp?” page and click Authorize.
Step 4: Ask your first question.
Try “List my WhatsApp Business numbers” or “Show chats that are waiting for a reply”.
Connection details
| Setting | Value |
|---|---|
| MCP server URL | https://mcp.services.timelines.ai/mcp/waba |
| Transport | Streamable HTTP |
| Sign-in | OAuth 2.1 with PKCE (S256) and dynamic client registration |
| Authorization server | https://mcp.services.timelines.ai |
| Scopes | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Tools (18)
Read tools only look at data. Write tools change a chat inside TimelinesAI. Sensitive write tools send something your customer sees, and template sends are charged by Meta.
| Tool | What it does | Access |
|---|---|---|
waba_accounts | Lists the WhatsApp Business Platform numbers you can send from | Read |
waba_list_chats | Lists the chats you can see, with filters (for example, by phone number) | Read |
waba_chat_details | Shows one chat: whether the 24-hour window is open, the assignee, labels and the sending number | Read |
waba_chat_history | Shows the messages in a chat, newest first | Read |
waba_message_details | Shows one message, including the reason if it failed | Read |
waba_templates | Lists the message templates you can use | Read |
waba_template_details | Shows one template: its content, variables, status and the numbers it can be sent from | Read |
workspace_team | Lists teammates, so a chat can be assigned to one of them | Read |
waba_chat_open | Reopens a closed chat | Write |
waba_chat_close | Closes a chat | Write |
waba_chat_assign | Assigns a chat to a teammate | Write |
waba_chat_unassign | Removes the assignee from a chat | Write |
waba_chat_set_label | Adds a label to a chat | Write |
waba_chat_remove_label | Removes a label from a chat | Write |
waba_chat_send_message | Sends a free-text reply in an existing chat, only while the 24-hour window is open | Sensitive write |
waba_chat_send_template | Sends an approved template in an existing chat | Sensitive writeMeta charges for templates |
waba_start_chat | Starts a new chat with a phone number using an approved template | Sensitive writeMeta charges for templates |
waba_message_react | Adds or removes an emoji reaction on a message | Sensitive writeThe customer sees it |
Every tool is labeled as read-only or as making changes, so AI assistants can ask you to confirm before a write runs.
What the assistant can see
The assistant acts as the TimelinesAI user who signed in, with that user’s permissions. It never sees more than that user can see in TimelinesAI.
- Owners and Admins see every WhatsApp Business Platform number in the workspace and all of its chats.
- Team supervisors and Teammates see the numbers whose team is set to their team, and those numbers’ chats.
- Agents see the numbers assigned to them, and those numbers’ chats.
- Collaborators see only the chats assigned to them. They can reply there, but can’t start new chats.
- Assigned chats: anyone assigned to a single chat can see and reply in that chat. That doesn’t open the rest of that number.
Messaging rules
- Inside the 24-hour window (the customer wrote in the last 24 hours), the assistant can send free-text replies.
- Outside the window, or for a new chat, only Meta-approved templates can be sent. A template doesn’t reopen the window for free text.
- Templates with a media header (image, video or document) can’t be sent through the connector yet. Use templates with text variables.
- Delivery: a successful send means Meta accepted the message. Delivery can still fail later, and the assistant can check the reason.
Pricing
Using the connector is included in every TimelinesAI plan at no extra charge. Meta charges for template messages at its standard WhatsApp Business Platform rates, and the assistant tells you before it sends one.
Privacy and security
- Sign-in uses OAuth, so your AI assistant never sees your TimelinesAI password.
- The assistant can only use the data the signed-in user can access, within the scopes above.
- To disconnect, remove the connector in your AI assistant.
- See our Privacy Policy and Terms. Help: help.timelines.ai.
FAQs about the WhatsApp Business Platform MCP server
Last updated: