Skip to content
MCP server

Wazap

Link your own WhatsApp account and let an agent search chats, media and groups

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
1.7.4
Listing updated
today

Similar MCP servers

About Wazap

Wazap is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add wazap -- npx -y wazap-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wazap": {
      "command": "npx",
      "args": [
        "-y",
        "wazap-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • WAZAP_READ_ONLYRefuse every write. The write tools are not registered at all.
  • WAZAP_DATA_DIRWhere wazap keeps credentials, history and media. Defaults to ~/.wazap.

Tools this server provides (23)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free; MIT-style open source badge; no paid plan mentioned

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

How AIPoweredBot checks servers