Skip to main content
plugin

wu-whatsapp — Claude Code plugin: features and installation

wu-whatsapp is a Claude Code plugin for WhatsApp chat search, message sending and contact lookup. Its commands also cover group listings, reactions and message exports.

MIT ★ 14 updated 2026-10-08

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add anthropics/claude-plugins-community
/plugin install wu-whatsapp@claude-community
Open on GitHub

What wu-whatsapp does

wu-whatsapp starts wu mcp as an MCP server, exposing WhatsApp tools to Claude Code. Slash commands cover chat and message search, sending messages, reacting to messages, exporting history and checking the connection. Claude can interact only with chats allowed by the constraint system.

Install wu-cli with npm install -g @ibrahimwithi/wu-cli, authenticate with wu login and configure chat constraints. For remote access, add a host with wu remote add <name> <host> and pull the database with wu sync pull; writes then travel to the remote daemon over SSH. In local-daemon mode, writes are disabled while the daemon owns the WhatsApp session.

What it helps with

  • search WhatsApp messages by text
  • send a message to an allowed chat
  • list contacts, groups and communities
  • export or count messages in a chat
  • retrieve nearby messages for context

Example prompts for the agent

  • Search WhatsApp for messages about “the meeting” with /wu-search.
  • Send “Starting in five minutes” to chat <jid> with /wu-send.
  • List my WhatsApp groups and communities.

How to install wu-whatsapp

Plugin marketplace

/plugin marketplace add anthropics/claude-plugins-community
/plugin install wu-whatsapp@claude-community

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about wu-whatsapp

How do I install wu-whatsapp in Claude Code?

Run /plugin marketplace add anthropics/claude-plugins-community, then /plugin install wu-whatsapp@claude-community.

What does wu-whatsapp do?

It connects Claude Code to WhatsApp tools through MCP. The plugin supports message search, chat operations and sending messages to chats allowed by its constraint system.

What does wu-whatsapp need to run?

Install wu-cli, authenticate with wu login and configure chat constraints. Remote mode also requires a VPS daemon, wu remote add <name> <host> and wu sync pull.

Source text

claude-plugin · MIT
# wu-whatsapp — Claude Code Plugin

WhatsApp integration for Claude Code. Send messages, search chats, list contacts, and more — all from Claude Code.

## Install

From inside Claude Code:

```
/plugin marketplace add ibrahimhajjaj/wu-cli
/plugin install wu-whatsapp@wu-cli
```

## Prerequisites

1. Install wu-cli: `npm install -g @ibrahimwithi/wu-cli`
2. Authenticate, either:
   - **Local**: `wu login` (this machine holds the WhatsApp session)
   - **Remote (VPS)**: `wu remote add <name> <host>` then sync with `wu sync pull`. The daemon runs on the VPS, your machine reads from a synced SQLite copy, and writes (send/react/etc.) route back over SSH.
3. Configure constraints for the chats you want Claude to access (see [Getting Started](../docs/getting-started.md#step-2-configure-constraints))

## Commands

| Command | Description |
|---|---|
| `/wu-send <jid> <message>` | Send a WhatsApp message |
| `/wu-search <query>` | Search messages (FTS5 full-text search) |
| `/wu-messages <jid>` | List messages in a chat |
| `/wu-chats` | List all chats |
| `/wu-groups` | List groups with community structure |
| `/wu-communities` | List communities and their subgroups |
| `/wu-dms` | List 1:1 chats (constraint-gated) |
| `/wu-contacts` | List all contacts |
| `/wu-react <jid> <id> <emoji>` | React to a message |
| `/wu-status` | Check connection status |
| `/wu-context <message-id>` | Get surrounding messages for context |
| `/wu-backfill <jid>` | Backfill older message history |
| `/wu-export <jid>` | Export WhatsApp messages to a file |
| `/wu-count <jid>` | Count messages in a chat |

## How It Works

The plugin starts `wu mcp` as an MCP server, giving Claude access to WhatsApp tools and resources. The slash commands are shortcuts that guide Claude to use the right tools with the right arguments.

All actions respect the constraint system — Claude can only interact with chats you've explicitly allowed.

### Operating modes

The MCP server detects which setup you're in and adapts:

| Mode | When | Reads | Writes |
|---|---|---|---|
| **local** | No daemon, no remote | Live WhatsApp | Live WhatsApp |
| **local-daemon** | `wu daemon` is running on this machine | Local SQLite | Disabled (daemon owns the session) |
| **remote** | `wu remote add` configured + synced DB | Local synced SQLite | Routed via SSH to the remote daemon |

Use `/wu-status` any time you want to verify which mode is active and whether the WhatsApp connection (local or remote) is healthy. In **remote** mode, `messages_stored` reflects the last sync; run `wu sync pull` to refresh.

© ibrahimhajjaj · MIT · ibrahimhajjaj/wu-cli

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open