WhatsApp MCP by TimelinesAI
Connects Claude directly to your TimelinesAI WhatsApp inbox via OAuth. You get 18 tools spanning chat discovery, message history, sends and replies, emoji reactions, label and teammate assignment, and workspace quota inspection. All writes hit the real inbox and consume your actual TimelinesAI messaging budget, same as the web UI. Recipients can't tell whether you typed it or Claude sent it. Requires a live TimelinesAI account with at least one connected WhatsApp number. Runs via the mcp-remote proxy over streamable HTTP. Useful if you're already managing customer support or sales conversations in TimelinesAI and want to triage, draft replies, or bulk-label chats without leaving your AI workspace.
- GitHub stars
- 5
- tools
- 34
- transport
- HTTP
- last updated
- Oct 8, 2026
Tools
34 toolsPublic tool metadata for what this MCP can expose to an agent.
workspace_quotasCurrent plan, seats, messaging + API call quotas, billing period
Current plan, seats, messaging + API call quotas, billing period
No parameter schema in public metadata yet.
workspace_whatsapp_accountsConnected QR WhatsApp accounts (id, phone, owner, status)
Connected QR WhatsApp accounts (id, phone, owner, status)
No parameter schema in public metadata yet.
workspace_teamTeammates, roles, invitation status, account bindings. Use for assign emails in both sets
Teammates, roles, invitation status, account bindings. Use for assign emails in both sets
No parameter schema in public metadata yet.
list_chatsFilter chats by status, labels, assignee, group/direct, phone, name, dates, WA account. Paginated 50/page
Filter chats by status, labels, assignee, group/direct, phone, name, dates, WA account. Paginated 50/page
No parameter schema in public metadata yet.
chat_detailsFull metadata for a single chat
Full metadata for a single chat
No parameter schema in public metadata yet.
chat_historyList messages in a chat. Filter by date and direction, page with message-UID cursors
List messages in a chat. Filter by date and direction, page with message-UID cursors
No parameter schema in public metadata yet.
message_detailsInspect a single message
Inspect a single message
No parameter schema in public metadata yet.
chat_send_messageSend a message (text, attachment, or reply) in an existing chat
Send a message (text, attachment, or reply) in an existing chat
No parameter schema in public metadata yet.
whatsapp_account_send_messageSend a message to any phone via a specific WA account (creates the chat if none exists: a cold send)
Send a message to any phone via a specific WA account (creates the chat if none exists: a cold send)
No parameter schema in public metadata yet.
message_replyThreaded reply to a specific message
Threaded reply to a specific message
No parameter schema in public metadata yet.
message_reactSet or clear an emoji reaction on a message
Set or clear an emoji reaction on a message
No parameter schema in public metadata yet.
chat_openReopen a closed chat
Reopen a closed chat
No parameter schema in public metadata yet.
chat_closeClose a chat
Close a chat
No parameter schema in public metadata yet.
chat_assignAssign chat to a teammate by email (use workspace_team to discover emails)
Assign chat to a teammate by email (use workspace_team to discover emails)
No parameter schema in public metadata yet.
chat_unassignUnassign current responsible teammate
Unassign current responsible teammate
No parameter schema in public metadata yet.
chat_set_labelAdd a label to a chat
Add a label to a chat
No parameter schema in public metadata yet.
chat_remove_labelRemove a label from a chat
Remove a label from a chat
No parameter schema in public metadata yet.
waba_accountsWABA numbers you can send from. Use id as waba_account_id
WABA numbers you can send from. Use id as waba_account_id
No parameter schema in public metadata yet.
waba_list_chatsWABA chats you can see. Filter by open/closed, assignee, WABA account, phone; 50/page. Check service_window_is_open before sending
WABA chats you can see. Filter by open/closed, assignee, WABA account, phone; 50/page. Check service_window_is_open before sending
No parameter schema in public metadata yet.
waba_chat_detailsOne WABA chat: service window, assignment, labels, WABA account
One WABA chat: service window, assignment, labels, WABA account
No parameter schema in public metadata yet.
waba_chat_historyMessages in a WABA chat, newest first. Filter by date and direction, page with message-UID cursors
Messages in a WABA chat, newest first. Filter by date and direction, page with message-UID cursors
No parameter schema in public metadata yet.
waba_message_detailsInspect one WABA message; failed sends include failure_reason
Inspect one WABA message; failed sends include failure_reason
No parameter schema in public metadata yet.
waba_templatesMessage templates you can use, 50/page. Only APPROVED templates can be sent
Message templates you can use, 50/page. Only APPROVED templates can be sent
No parameter schema in public metadata yet.
waba_template_detailsOne template's components, status, and the WABA accounts it can be sent from. Call before any template send
One template's components, status, and the WABA accounts it can be sent from. Call before any template send
No parameter schema in public metadata yet.
waba_start_chatStart a new chat with a phone number using an approved template. Meta charge
Start a new chat with a phone number using an approved template. Meta charge
No parameter schema in public metadata yet.
waba_chat_send_messageFree-text message in an existing WABA chat, only while service_window_is_open is true
Free-text message in an existing WABA chat, only while service_window_is_open is true
No parameter schema in public metadata yet.
waba_chat_send_templateSend an approved template in an existing WABA chat: the way to message when the service window is closed. Meta charge
Send an approved template in an existing WABA chat: the way to message when the service window is closed. Meta charge
No parameter schema in public metadata yet.
waba_message_reactSet or clear an emoji reaction on a WABA message
Set or clear an emoji reaction on a WABA message
No parameter schema in public metadata yet.
waba_chat_openReopen a closed WABA chat
Reopen a closed WABA chat
No parameter schema in public metadata yet.
waba_chat_closeClose a WABA chat
Close a WABA chat
No parameter schema in public metadata yet.
waba_chat_assignAssign a WABA chat to a teammate by email (from workspace_team)
Assign a WABA chat to a teammate by email (from workspace_team)
No parameter schema in public metadata yet.
waba_chat_unassignClear the WABA chat's assignee
Clear the WABA chat's assignee
No parameter schema in public metadata yet.
waba_chat_set_labelAdd a label, keeping existing labels
Add a label, keeping existing labels
No parameter schema in public metadata yet.
waba_chat_remove_labelRemove one label, keeping the others; no-op if the label isn't on the chat
Remove one label, keeping the others; no-op if the label isn't on the chat
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
WhatsApp MCP by TimelinesAI
Run your team's WhatsApp inbox from Claude, ChatGPT, Cursor or any AI assistant.
Connect your TimelinesAI WhatsApp inbox to Claude, ChatGPT, Cursor, Codex, Grok or any MCP client. Ask what needs a reply, then reply, react, label and assign chats from a prompt. 34 tools, all running as you, for both regular WhatsApp numbers and WhatsApp Business API (WABA) numbers.
Details
- Repository
- github.com/initechsoftware/whatsapp-mcp-by-timelinesai
- Category
- Communication & Messaging
- Transport
- HTTP
- Registry
- MCP registry, active
Related Communication & Messaging MCP servers
View all
Email (IMAP/SMTP)boutquin/mcp-server-emailMulti-account IMAP/SMTP email server with 22 tools for reading, sending, searching, and organizing.2stars
Faithk7 Gmail Mcpfaithk7/gmail-mcpManage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…0stars
Prelimchat.prelim/prelimRead AI preliminary phone screens — your roles, candidate scores, transcripts, and analytics.0stars
Gmailio.github.mcp-z/mcp-gmailGmail integration with OAuth authentication, message search, batch operations, and Sheets export0stars
Gmailpulsemcp/mcp-serversMCP server for Gmail with OAuth2 (personal) and service account (Workspace) support.0stars