# WhatsApp MCP by TimelinesAI

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: InitechSoftware
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/InitechSoftware/whatsapp-mcp-by-timelinesai
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/whatsapp-mcp-by-timelinesai

## What it 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.

## Requirements
- Remote server: `https://mcp.services.timelines.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add whatsapp-mcp-by-timelinesai --url https://mcp.services.timelines.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whatsapp-mcp-by-timelinesai": {
            "url": "https://mcp.services.timelines.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whatsapp-mcp-by-timelinesai": {
            "type": "http",
            "url": "https://mcp.services.timelines.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http whatsapp-mcp-by-timelinesai https://mcp.services.timelines.ai/mcp
```

## When to use it
- find chats that need a reply
- read and send WhatsApp messages
- apply labels and assign chats to teammates
- configure inbox webhooks

## Example prompts
- Show me the chats that need a reply today.
- Read the latest messages in this chat and draft a response.
- Apply the `urgent` label to this chat and assign it to a teammate.

## Similar
- [whatsapp-automation](https://affpapa.org/en/nevibecode/skills/whatsapp-automation.md) — skill · 6700 installs
- [integrate-whatsapp](https://affpapa.org/en/nevibecode/skills/integrate-whatsapp.md) — skill · 5400 installs
- [whatsapp-cloud-api](https://affpapa.org/en/nevibecode/skills/whatsapp-cloud-api.md) — skill · 711 installs
- [mcp-whatsapp-cloud](https://affpapa.org/en/nevibecode/mcp/mcp-whatsapp-cloud.md) — MCP server · ★ 279 repo stars
- [WhatsApp Business API by Wassenger](https://affpapa.org/en/nevibecode/mcp/whatsapp-business-api-by-wassenger.md) — MCP server · ★ 6 repo stars
- [Green API WhatsApp](https://affpapa.org/en/nevibecode/mcp/green-api-whatsapp.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
