# whatsapp

Connects your WhatsApp to any MCP client: read, search and optionally send messages through a bearer token, with nothing running locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 3
- Author: wacli-me
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/wacli-me/wacli-me
- Updated: 2026-09-23
- HTML: https://affpapa.org/en/nevibecode/mcp/whatsapp

## What it does

wacli.me is a hosted MCP gateway that sits in front of the wacli CLI. You link an account once by scanning a QR code, the same way WhatsApp Web does it, and get back a URL plus a bearer token. From there an MCP client can read and search messages; sending is a separate switch.

The server speaks Streamable HTTP at `/mcp` and expects `Authorization: Bearer …`. Each token in `config/tenants.json` maps to exactly one store directory, so tenants stay isolated from one another. That file is re-read every 5 seconds, which means a new tenant goes live without a restart. The `send_message` tool only appears when `allowSend` is `true`; keep it `false` unless the account owner asked for write access.

Reads call wacli with `--read-only`, so a bad tool call cannot change the store. Skip the sync daemon and the store holds only what the last run pulled. Linking relies on an unofficial WhatsApp client, which breaks WhatsApp's terms of service and can get a number blocked by Meta. Use it on accounts you own.

## Requirements
- Remote server: `https://wacli.me/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http whatsapp https://wacli.me/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add whatsapp --url https://wacli.me/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "whatsapp": {
            "url": "https://wacli.me/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "whatsapp": {
            "type": "http",
            "url": "https://wacli.me/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http whatsapp https://wacli.me/mcp
```

## When to use it
- find a message without picking up the phone
- pull chat history into an agent session
- send a WhatsApp message from an MCP client
- keep several accounts in separate stores
- self-host a gateway to WhatsApp with no local install

## Example prompts
- Search my WhatsApp for messages from Ivan last week
- Show the latest messages in the team chat
- Send a WhatsApp note: the meeting moved an hour later

## Similar
- [mcp-whatsapp-cloud](https://affpapa.org/en/nevibecode/mcp/mcp-whatsapp-cloud.md) — MCP server · ★ 274
- [whatsapp-automation](https://affpapa.org/en/nevibecode/skills/whatsapp-automation.md) — skill · 6500 installs
- [whatsapp-marketing](https://affpapa.org/en/nevibecode/skills/whatsapp-marketing.md) — skill · 1600 installs
- [whatsapp-cloud-api](https://affpapa.org/en/nevibecode/skills/whatsapp-cloud-api.md) — skill · 657 installs
- [Green API WhatsApp](https://affpapa.org/en/nevibecode/mcp/green-api-whatsapp.md) — MCP server
- [twilio-whatsapp-send-message](https://affpapa.org/en/nevibecode/skills/twilio-whatsapp-send-message.md) — skill · 2 installs

---
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