# Wazap

> Wazap is an open-source MCP server for communication. Link your own WhatsApp account and let an agent search chats, media and groups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/razvangirgiz/wazap
- **MCP Registry name:** io.github.razvangirgiz/wazap
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

Wazap links to your WhatsApp as a device, the way WhatsApp Web does, and keeps what it sees on your machine under ~/.wazap by default. The README stresses there is no wazap cloud, no browser and no business account. Linking uses a QR code or an 8-character pairing code, and several accounts can live in one install.

Its 23 tools mix reads, local notes and writes. Search works by meaning and by words together, voice notes come back as transcripts, and catch_up answers what you missed across every linked account within a token budget. Sending is two steps: send_message only drafts, and confirm_send sends after you have seen the recipient and exact text. Drafts can be scheduled with send_at, and a message that could not go within 15 minutes of its time is reported as missed rather than sent late.

Setting WAZAP_READ_ONLY stops the write tools being registered at all. Setup needs Node.js 22.16 or newer on the 22 line, or 24+, and a phone with WhatsApp; hosted clients such as claude.ai and ChatGPT can connect through an OAuth URL.

## Features

- **Draft then confirm:** Messages are drafted first and sent only after you approve the preview.
- **Catch-up summary:** One call shows who is waiting, mentions and missed calls across accounts.
- **Hybrid search:** Finds messages by meaning and by words, filtered by chat, sender or date.
- **Media as text:** Voice notes become transcripts and documents come back as text.
- **Scheduling and reminders:** Send later or be reminded if someone has not answered.
- **Read-only mode:** WAZAP_READ_ONLY keeps write tools from being registered.
- **Multiple accounts:** Several WhatsApp accounts in one install.

## Good for

- Ask what you missed on WhatsApp today
- Find an invoice a contact sent months ago
- Have a voice note read back as text
- Schedule a message for tomorrow morning
- Run read-only access on a work phone

## Install

### Claude Code (Terminal)

```sh
claude mcp add wazap -- npx -y wazap-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wazap": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
```

## Tools

- `learn`: Guide by topic for ids, workflows and errors
- `get_status`: Connection, sync and linked account status
- `link_account`: Link an account and return a pairing code
- `list_chats`: List conversations newest first
- `read_messages`: Read one chat
- `catch_up`: Summary of what you missed across accounts
- `search`: Search messages by meaning and words
- `get_message`: One message in full with reactions and receipts
- `find_contact`: Resolve a name or nickname to a contact
- `list_contacts`: Page through the address book
- `get_group_info`: Group participants, admins and settings
- `get_media`: Voice note transcript, image, video contact sheet or document text
- `wait_for_messages`: Block until a message arrives
- `remember`: Keep a local note about a person
- `send_message`: Draft a message, media, poll or location without sending
- `confirm_send`: Send a previewed draft once
- `edit_message`: Edit your own message
- `react_to_message`: Add or remove a reaction
- `delete_message`: Delete a message
- `manage_chat`: Archive, pin, mute, star, clear, delete or block with preview
- `manage_group`: Create, join and administer groups
- `scheduled_messages`: List or cancel scheduled messages
- `reminder`: Set, list or cancel reminders

## FAQ

### Does it send messages on its own?

No. send_message drafts and confirm_send sends only after you have seen the preview and said yes.

### Where is my data kept?

On your machine, in ~/.wazap unless WAZAP_DATA_DIR is set.

### How do I link my account?

Run npx wazap-mcp setup or login, then scan a QR or enter an 8-character pairing code.

### Can I stop it from writing?

Yes, set WAZAP_READ_ONLY to true.

### Is Wazap free?

Yes. Wazap is open source, so you can use and self-host it for free.

### How do I add Wazap to Claude Code?

Run this command in your terminal: claude mcp add wazap -- npx -y wazap-mcp

### What are the best alternatives to Wazap?

The closest alternatives to Wazap are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/wazap
