WhatsApp MCP by TimelinesAI

Run your WhatsApp inbox from Claude, Cursor or Codex using plain prompts

Intermediate API
Screenshot of WhatsApp MCP by TimelinesAI, Run your WhatsApp inbox from Claude, Cursor or Codex using plain prompts

What is WhatsApp MCP by TimelinesAI?

WhatsApp MCP by TimelinesAI is a communication tool. A remote MCP server from TimelinesAI that lets Claude, Cursor, Codex and other MCP clients read, triage, label, assign and reply to WhatsApp chats through prompts. It uses OAuth sign-in, needs no API key, and connects personal or business numbers by QR code.

WhatsApp MCP by TimelinesAI is a remote Model Context Protocol server that gives AI agents hands-on access to a real WhatsApp inbox. Once the connector is added, an MCP-capable assistant gets 18 tools for browsing chats, reading history, sending replies, labelling, assigning conversations and checking workspace state. Instead of clicking through a dashboard, the user describes the job in a sentence and the agent carries it out. The product is aimed at sales, support and operations teams that already handle customer conversations on WhatsApp, along with developers who want an agent to act on that inbox. Typical prompts on the page include grouping unread chats by rep and flagging anything stalled for two days, reassigning overnight chats to the right person, rebalancing workload across a team, and cleaning up labels by merging duplicates or tagging every chat that mentions a refund. In practice, setup is short. A TimelinesAI account with at least one connected WhatsApp number is required, since the server controls a live inbox rather than a demo environment. For Claude Code, a single terminal command registers the connector, a browser tab opens for OAuth sign-in, and prompting can begin. No API key is needed for the MCP route, and no WhatsApp Business API approval is required: personal or business numbers connect by scanning a QR code, and WABA numbers are supported as well. Claude Code, Cursor and Codex have documented setup paths, Claude Desktop uses the same configuration, and other MCP clients can point at the same server URL. OpenClaw and Hermes connect through skill packages that use the public API and a token. Buyers should take the safety model seriously. Messages sent through the agent are real, immediate and indistinguishable from ones typed by the user, and actions inherit the user's existing role permissions. Drafts saved as private notes offer a way to keep a human approving each send. Compared with building a custom integration on the WhatsApp Business API, this route trades flexibility for speed, and it sits alongside TimelinesAI's wider shared-inbox and CRM sync platform.

How do you use WhatsApp MCP by TimelinesAI?

  1. 1Connect a WhatsApp number
    Create a TimelinesAI account and scan the QR code to link at least one WhatsApp number. Without a connected number, most MCP tools return empty results.
    WhatsApp MCP by TimelinesAI — Connect a WhatsApp number
  2. 2Add the connector to your client
    In Claude Code, run the claude mcp add command shown on the page, pointing at the TimelinesAI MCP server URL. Cursor and Codex have their own steps in the full guide.
    WhatsApp MCP by TimelinesAI — Add the connector to your client
  3. 3Restart and sign in with OAuth
    Restart the client and a browser tab opens on first use. Sign in with your TimelinesAI account; no API key is needed.
  4. 4Start with a read-only prompt
    Try triage first, such as grouping unread chats by rep and flagging anything stalled for two days. Reading is safer than sending while you learn how the agent behaves.
  5. 5Browse ready-made skills
    Look through the WhatsApp MCP skills page for prompt patterns covering routing, labelling and reporting, and adapt them to your team.
    WhatsApp MCP by TimelinesAI — Browse ready-made skills
  6. 6Keep a human on sends
    Ask the agent to save replies as private notes, then approve and send them yourself. Check remaining headroom with the workspace_quotas tool.

Pros and cons

Pros

  • Setup is quick: one command for Claude Code, then browser OAuth sign-in with no API key to generate or rotateAI
  • Works with existing personal or business WhatsApp numbers via QR code, with no Business API approval processAI
  • Exposes 18 tools covering chat browsing, history, replies, labels, assignments and workspace checksAI
  • Compatible with any MCP client, with documented setups for Claude Code, Cursor and CodexAI
  • Actions run under the user's own role permissions, and drafts can be saved as private notes for human approvalAI

Cons

  • Requires a TimelinesAI account with a connected WhatsApp number; without one most tools return empty resultsAI
  • Sends are immediate with no sandbox and no undo, so a poorly worded prompt can message real customersAI
  • MCP-sent messages count against the same monthly messaging quota as normal TimelinesAI usageAI
  • OpenClaw and Hermes use skill packages built on the public API and need a token, and Hermes support is marked as coming soonAI
  • Recipients cannot tell AI-sent messages from human ones, which raises disclosure and compliance questions for some teamsAI

How much does WhatsApp MCP by TimelinesAI cost?

Free trial

A 10-day free trial is offered with no credit card required, and the page says setup takes about two minutes.

Learn more

Pricing

MCP use has no separate meter: messages sent through it draw on the same monthly messaging quota as regular TimelinesAI usage. Plan prices are not stated on the page.

Learn more

Support

A full WhatsApp MCP guide, a skills library, a YouTube walkthrough and a demo booking option are offered. A customer review on the page also mentions a helpful support team.

Learn more

Integrations

Works with Claude Code, Cursor and Codex (documented), Claude Desktop, ChatGPT and any MCP-compatible client. OpenClaw and Hermes connect through skill packages. Supports personal, business and WABA WhatsApp numbers.

Learn more

Features

18 MCP tools for browsing chats, reading history, sending replies, labelling, assigning and checking workspace state. Example uses include inbox triage, bulk reassignment, workload rebalancing, label cleanup, drafts as private notes and quota checks via workspace_quotas.

Learn more

Frequently asked questions about WhatsApp MCP by TimelinesAI

  • How much does WhatsApp MCP by TimelinesAI cost?
    MCP use has no separate meter: messages sent through it draw on the same monthly messaging quota as regular TimelinesAI usage. Plan prices are not stated on the page.
  • Does WhatsApp MCP by TimelinesAI offer a free trial?
    A 10-day free trial is offered with no credit card required, and the page says setup takes about two minutes.
  • Does WhatsApp MCP by TimelinesAI have an API?
    Yes, WhatsApp MCP by TimelinesAI offers an API.
  • How do you use WhatsApp MCP by TimelinesAI?
    The walkthrough on this page covers 6 steps: 1. Connect a WhatsApp number 2. Add the connector to your client 3. Restart and sign in with OAuth 4. Start with a read-only prompt 5. Browse ready-made skills 6. Keep a human on sends.
  • What platforms does WhatsApp MCP by TimelinesAI support?
    WhatsApp MCP by TimelinesAI is available on Web App.
  • What does WhatsApp MCP by TimelinesAI integrate with?
    Works with Claude Code, Cursor and Codex (documented), Claude Desktop, ChatGPT and any MCP-compatible client. OpenClaw and Hermes connect through skill packages. Supports personal, business and WABA WhatsApp numbers.

Status

StatusActive
Views0
Outbound clicks0
Added10/8/2026

Platforms

Web App

Pricing

Free TrialSubscription