WhatsApp MCP by TimelinesAI

What is WhatsApp MCP by TimelinesAI?

WhatsApp MCP by TimelinesAI gives your AI assistant access to your team's real WhatsApp inbox in TimelinesAI. Ask which chats need a reply, who has waited longest or what a customer asked last week, then reply, react, label, open or close chats and assign them to teammates, without opening the inbox.

Every action runs as you, with your role's permissions, and uses the same messaging quota as the TimelinesAI app. It works with regular WhatsApp numbers connected by QR code and with WhatsApp Business API numbers, including approved message templates.

How to use it?

1. Start a TimelinesAI account (10-day free trial, no credit card) and connect a WhatsApp number.
2. Add TimelinesAI to your AI assistant. It's a hosted remote server (Streamable HTTP), so there's nothing to install: https://mcp.services.timelines.ai/mcp. Install it from your assistant's plugin or app directory where available, or add the URL as a remote server. Claude Code: claude mcp add --transport http timelinesai https://mcp.services.timelines.ai/mcp. Setup for each assistant: https://timelines.ai/whatsapp-mcp
3. Sign in with your TimelinesAI account (OAuth). No API keys.
4. Ask in plain language, for example: "What needs me today?"

Key features

• Ask your inbox: find chats waiting on a reply, summarise conversations, check your quota
• Act from a prompt: reply, react, label, assign, open and close chats
• Regular WhatsApp numbers and the WhatsApp Business API, including approved templates
• Works with ChatGPT, Claude, Cursor, Codex, Grok and other AI assistants
• One sign-in with your TimelinesAI account (OAuth), no API keys
• Included in every TimelinesAI plan at no extra charge

Tools (34)

• Workspace (3): workspace_quotas, workspace_whatsapp_accounts, workspace_team
• WhatsApp numbers connected by QR code (14): list_chats, chat_details, chat_history, message_details, chat_send_message, whatsapp_account_send_message, message_reply, message_react, chat_open, chat_close, chat_assign, chat_unassign, chat_set_label, chat_remove_label
• WhatsApp Business API (17): waba_accounts, waba_list_chats, waba_chat_details, waba_chat_history, waba_message_details, waba_templates, waba_template_details, waba_start_chat, waba_chat_send_message, waba_chat_send_template, waba_message_react, waba_chat_open, waba_chat_close, waba_chat_assign, waba_chat_unassign, waba_chat_set_label, waba_chat_remove_label

Use cases

• Team leads and managers: a morning briefing of what's waiting, who's behind, what's stalled
• Sales teams: follow-ups on leads that went quiet, without scrolling the inbox
• Support teams: triage, labelling and assignment from the assistant they already use

FAQ

Is it free? It's included in every TimelinesAI plan at no extra charge. Plans start at $35 per seat a month, with a 10-day free trial.

Does it need an API key? No. You sign in with your TimelinesAI account (OAuth).

Can it send messages? Yes, as you, from your own WhatsApp numbers, using your normal messaging quota. WhatsApp Business API template messages are charged by Meta.

Is there a sandbox? No. It works on your real inbox, so try it on your own number first.

Is it open source? The docs and client configs on GitHub are MIT-licensed. The server is hosted by TimelinesAI.