WhatsApp MCP by TimelinesAI

Full-blown MCP server — every workspace action exposed to your AI assistant.

Drive your TimelinesAI WhatsApp inbox from Claude, Cursor, Claude Code, or any MCP-compatible client. List chats, read history, send messages, react, label, assign teammates, check quotas — all 18 tools, all as you, all on the same quota the TimelinesAI UI uses.

What is this?

The TimelinesAI MCP server is a remote control for your real WhatsApp inbox inside TimelinesAI. Connect once via OAuth, then your AI assistant gains 18 tools across chat discovery, messaging, triage (labels + assignments), and workspace introspection.

No sandbox. Writes are real and visible to your contacts. Recipients cannot tell whether a message came from the UI or from an AI assistant — it's all just you.

Requirements

• A working TimelinesAI production account with at least one connected WhatsApp account in your workspace. Without a connected WA, most tools will return empty or error — the MCP is a remote control for your real inbox, not a sandbox.
• Node.js 18+ locally (Cursor / Claude Desktop / Claude Code use npx to launch the mcp-remote proxy).

Don't have a TimelinesAI account yet? Sign up free →

Quick setup (~1 min)

Claude Code (CLI)

claude mcp add timelinesai -- npx -y mcp-remote@latest https://mcp.services.timelines.ai/mcp --host 127.0.0.1

Restart Claude Code. A browser tab will open on first use — log in with your TimelinesAI account to authorize. Done.

Claude Code (plugin)

Prefer one-step install via the TimelinesAI plugin marketplace:

/plugin marketplace add InitechSoftware/whatsapp-mcp-by-timelinesai
/plugin install timelinesai-whatsapp@timelinesai

This auto-wires the MCP server — no manual config. A browser tab opens on first use for OAuth. Update later with /plugin marketplace update timelinesai.

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "timelinesai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.services.timelines.ai/mcp",
        "--host", "127.0.0.1"
      ]
    }
  }
}

Restart Cursor.

Claude Desktop

Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "timelinesai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.services.timelines.ai/mcp",
        "--host", "127.0.0.1"
      ]
    }
  }
}

Fully quit Claude Desktop (not just close the window) and reopen. A browser tab will open for OAuth on first use.

See examples/ for ready-to-copy config snippets per client.

First thing to try

After your client restarts, ask it:

"What tools does the timelinesai MCP server expose? Group them by purpose and give me one example prompt per group."

That gives you a personalized tour of what's available without reading any docs.

Tool catalog (18 tools)

Workspace meta — 3 tools

Read-only introspection. Cheap to call.

... View full README on GitHub