TimelinesAI

WhatsApp MCP for any AI

Connect your WhatsApp inbox to Claude, ChatGPT, Cursor, or your agent framework — and manage every chat, label, and reply straight from your prompts.

How does MCP work?

Ask your AI agent to take real actions in your WhatsApp inbox — no dashboard, just a prompt.

Connect your WhatsApp inbox to your AI

Scan a QR code, add the connector, and start prompting. No WhatsApp Business API, no developer, no API keys.

No credit card · 2-min setup · Cancel anytime
Customer stories

Teams in 34 countries already run WhatsApp on TimelinesAI

The MCP connector plugs into the same workspace these teams use every day — same inbox, same permissions, same quota.

1,500+Active teams
4.6★Capterra rating
10M+Messages managed
2minMedian setup
★★★★★

“We connected 12 WhatsApp numbers to one shared inbox and the CRM sync just works. Setup took about 3 minutes — no API keys, no developer needed.”

VU Verified User Sales Manager, Real Estate (Capterra)
★★★★★

“Before TimelinesAI we were losing conversations across 5 different phones. Now every message is logged in HubSpot automatically and the team can pick up any chat without context loss.”

VU Verified User Head of Customer Success, SaaS (Capterra)
★★★★★

“The mass messaging feature alone paid for itself in the first week. We send personalized broadcasts to 2,000+ contacts and every reply lands right in the shared inbox.”

VU Verified User Operations Lead, E-commerce (Capterra)
Questions

What to know before you connect

What is MCP, exactly?

Model Context Protocol — an open standard that lets AI agents use external tools. Connect the TimelinesAI server once and your agent gains 18 tools for browsing chats, reading history, sending replies, labelling, assigning, and checking workspace state.

Do I need an API key?

No. The MCP server uses OAuth — a browser tab opens on first use and you sign in with your TimelinesAI account. Nothing to generate, paste, or rotate. (The OpenClaw and Hermes skill packages are the exception; those use the public API and do need a token.)

Which AI tools can connect?

Claude Code, Cursor, and Codex have documented, tested setup paths — those are the three covered in the full guide. Claude Desktop works with the same config. Any other MCP-compatible client can point at the same server URL. OpenClaw and Hermes connect through a skill package instead.

Can the AI actually send messages to my customers?

Yes — and it's worth being clear about it. Sends are real and immediate, there is no sandbox and no undo, and recipients cannot tell an MCP-sent message from one you typed in the UI. Every action runs as you, so your role's existing permissions in TimelinesAI apply exactly as they do in the interface. If you want AI drafting without AI sending, ask for drafts saved as private notes and approve them yourself.

Does using MCP cost extra?

Messages sent through MCP draw on the same monthly messaging quota as normal TimelinesAI usage — it's one shared budget, not a separate meter. Ask your agent to call workspace_quotas any time to see remaining headroom.

Do I need the WhatsApp Business API?

No. TimelinesAI works with your existing personal or business WhatsApp accounts — scan a QR code and messages start syncing, with no Meta approval process. WABA numbers are supported too if you already use them.

What do I need before the setup steps work?

A TimelinesAI account with at least one WhatsApp number connected. The MCP server is a remote control for a real inbox rather than a demo environment, so without a connected number most tools return empty results.

Ready to connect WhatsApp to your AI?

Start your 10-day free trial today. No credit card required, and setup takes under 2 minutes.

Works with Claude · ChatGPT · Cursor · Codex · any MCP client