WhatsApp MCP by TimelinesAI

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. It is available as a remote MCP endpoint.

Teams that work with chat, message and workspace and want a hosted endpoint instead of running a local process.

VERIFIED ACTIVE

LAST COMMIT 2026-05-29 · ★ 3 · #107 OF 109 MAINTAINED COMMUNICATION · VERIFIED 2026-09-30

MIT · how we verify → /methodology

01 · Install WhatsApp MCP by TimelinesAI

Claude Code

claude mcp add initechsoftware-whatsapp-mcp-by-timeline --transport http https://mcp.services.timelines.ai/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "initechsoftware-whatsapp-mcp-by-timeline": {
      "url": "https://mcp.services.timelines.ai/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://mcp.services.timelines.ai/mcp

transport: streamable-http

endpoint alive - authentication required · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as remote - your agent's requests go to mcp.services.timelines.ai

endpoint auth requires authentication - rejected our unauthenticated MCP initialize

license MIT - declared in the repository

registry namespace io.github.InitechSoftware is GitHub-verified and matches the repo owner

03 · What WhatsApp MCP by TimelinesAI can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can filter chats by status, labels, assignee, group/direct, phone, name, dates, WA account - paginated 50/page, inspect a single message, send a message (text, attachment, or reply) in an existing chat, and send a message to any phone via a specific WA account (creates chat if none exists - cold send).

Capability map

Tools grouped from the project's README - what WhatsApp MCP by TimelinesAI lets an agent do.

Chat

10 tools - e.g. Full metadata for a single chat; Conversation context window around a specific message; Page through messages in a chat

chat_details · chat_history · get_chat_messages · chat_send_message · chat_open · chat_close…

Message

4 tools - e.g. Inspect a single message; Send a message to any phone via a specific WA account (creates chat if none exists - cold send); Threaded reply to a specific message

message_details · whatsapp_account_send_message · message_reply · message_react

Workspace

3 tools - e.g. Current plan, seats, messaging + API call quotas, billing period; Connected WhatsApp accounts (id, phone, owner, status); Teammates, roles, invitation status, account bindings

workspace_quotas · workspace_whatsapp_accounts · workspace_team

read & search

1 tool - e.g. Filter chats by status, labels, assignee, group/direct, phone, name, dates, WA account - paginated 50/page

list_chats

04 · Who maintains WhatsApp MCP by TimelinesAI

WhatsApp MCP by TimelinesAI is maintained by initechsoftware. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

category
communication - ranked #107 of 109 actively-maintained communication servers as of 2026-09-30.
registry
io.github.InitechSoftware/whatsapp-mcp-by-timelinesai (active, first published 2026-05-13 · 2 versions)

06 · WhatsApp MCP by TimelinesAI FAQ

Is WhatsApp MCP by TimelinesAI still maintained?

Yes - as of 2026-09-30, its last commit was 2026-05-29. We re-verify nightly.

What can WhatsApp MCP by TimelinesAI do?

With this server connected, an agent can filter chats by status, labels, assignee, group/direct, phone, name, dates, WA account - paginated 50/page, inspect a single message, send a message (text, attachment, or reply) in an existing chat, and send a message to any phone via a specific WA account (creates chat if none exists - cold send).

How do I install WhatsApp MCP by TimelinesAI?

Run `claude mcp add initechsoftware-whatsapp-mcp-b --transport http https://mcp.services.timelines.ai/mcp`. You can also paste the ready-made client config above.

Does WhatsApp MCP by TimelinesAI require authentication?

Yes - when we probed the endpoint on 2026-09-30, it rejected an unauthenticated MCP initialize; you'll need credentials to connect.

07 · Alternatives to WhatsApp MCP by TimelinesAI

More communication MCP servers · Marktplaats & 2dehands · Telegram MCP · Talkback · Clawaimail