WhatsApp MCP by TimelinesAI — Claude Code MCP server
WhatsApp MCP by TimelinesAI is a Claude Code MCP server that connects an assistant to a TimelinesAI WhatsApp inbox. It finds chats and handles inbox actions from prompts.
MIT ★ 7 updated 2026-11-17
claude mcp add --transport http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcpWhat WhatsApp MCP by TimelinesAI does
WhatsApp MCP by TimelinesAI connects an AI assistant to a WhatsApp inbox in TimelinesAI. It can find chats, read and send messages, add reactions, edit labels and assignments, handle notes and saved replies, configure webhooks, and invite teammates. Regular WhatsApp numbers and WABA numbers use separate tool sets.
The server is hosted remotely. Add https://mcp.services.timelines.ai/mcp and sign in to TimelinesAI once. It requires a TimelinesAI account, at least one connected WhatsApp number, and an AI client that supports remote MCP servers. Writes go to the live inbox and are visible to contacts; this is not a sandbox.
What it helps with
- find chats that need a reply
- read and send WhatsApp messages
- apply labels and assign chats to teammates
- configure inbox webhooks
Example prompts for the agent
- Show me the chats that need a reply today.
- Read the latest messages in this chat and draft a response.
- Apply the
urgentlabel to this chat and assign it to a teammate.
How to install WhatsApp MCP by TimelinesAI
Platform CLI: remote server
claude mcp add --transport http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcpPlatform CLI: remote server
codex mcp add whatsapp-mcp-by-timelinesai --url https://mcp.services.timelines.ai/mcpConfig file
{
"mcpServers": {
"whatsapp-mcp-by-timelinesai": {
"url": "https://mcp.services.timelines.ai/mcp"
}
}
}Config file
{
"servers": {
"whatsapp-mcp-by-timelinesai": {
"type": "http",
"url": "https://mcp.services.timelines.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WhatsApp MCP by TimelinesAI
How do I install WhatsApp MCP by TimelinesAI in Claude Code?
Run claude mcp add --transport http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcp, then sign in to TimelinesAI in the browser window opened on the first tool call.
What does WhatsApp MCP by TimelinesAI do?
It connects an AI assistant to a TimelinesAI WhatsApp inbox. Prompts can search chats, read and send messages, change labels and assignments, manage notes and saved replies, and configure webhooks.
What does WhatsApp MCP by TimelinesAI require?
It requires a TimelinesAI account, at least one connected WhatsApp number, and an AI client that supports remote MCP servers. No API key is needed.