Wazap
Link your own WhatsApp account and let an agent search chats, media and groups
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"wazap": {
"command": "npx",
"args": [
"-y",
"wazap-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"wazap": {
"command": "npx",
"args": [
"-y",
"wazap-mcp"
]
}
}
}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.

