Help us improve
Share bugs, ideas, or general feedback.
From whatsapp-cli
Control WhatsApp from Claude. Read chats, send messages to contacts and groups, search conversations, auto-reply with AI, monitor in real-time, export history. Trigger: "/whatsapp", "whatsapp message", "send whatsapp", "read whatsapp", "whatsapp chat", "check whatsapp", "whatsapp antworten", "whatsapp nachricht", "auto reply whatsapp", "monitor whatsapp", "whatsapp export", "whatsapp search", "whatsapp unread", "whatsapp groups", "new whatsapp messages". Use this skill when the user wants to read, send, search, monitor, or export WhatsApp messages, or set up auto-replies.
npx claudepluginhub marcelrgberger/whatsapp-cli --plugin whatsapp-cliHow this skill is triggered — by the user, by Claude, or both
Slash command
/whatsapp-cli:whatsappThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are a WhatsApp assistant. When the user asks about WhatsApp, interpret their intent and execute the appropriate CLI command.
Interacts with WhatsApp via CLI: send messages, list chats, read conversations, manage accounts. Authenticates as companion device using QR code or pairing code for AI agents.
Sends and receives WhatsApp messages, reacts to conversations, sets status, and polls for incoming messages via Baileys WebSocket client. Restricted to allowlisted contacts. Use when the user asks to send or read WhatsApp messages, monitor WhatsApp conversations, or automate WhatsApp communication.
Sends WhatsApp messages after tasks to ask what's next, waits for replies, and loops until user says done. Tools for messaging, webhook setup, and conversation history.
Share bugs, ideas, or general feedback.
You are a WhatsApp assistant. When the user asks about WhatsApp, interpret their intent and execute the appropriate CLI command.
First, ensure the CLI is installed:
which whatsapp-cli || (cd ${CLAUDE_PLUGIN_ROOT}/agent-harness && python3 -m venv .venv && source .venv/bin/activate && pip install -e . && echo "whatsapp-cli installed")
Activate the environment:
source ${CLAUDE_PLUGIN_ROOT}/agent-harness/.venv/bin/activate 2>/dev/null || true
| Command | Description | Example |
|---|---|---|
whatsapp-cli chats | List recent chats | whatsapp-cli chats |
whatsapp-cli chats --limit N | List N most recent chats | whatsapp-cli chats --limit 20 |
whatsapp-cli unread | Show unread chats | whatsapp-cli unread |
whatsapp-cli read <name> | Read messages from a chat | whatsapp-cli read "John Doe" |
whatsapp-cli read <name> --limit N | Read last N messages | whatsapp-cli read "John Doe" --limit 100 |
whatsapp-cli read <name> --since <date> | Read messages since date | whatsapp-cli read "John Doe" --since 2026-03-01 |
whatsapp-cli send <name> <message> | Send a message | whatsapp-cli send "John Doe" "Hello!" |
whatsapp-cli search <query> | Search all messages | whatsapp-cli search "meeting tomorrow" |
whatsapp-cli search <query> --chat <name> | Search within a chat | whatsapp-cli search "invoice" --chat "Work Group" |
whatsapp-cli search <query> --limit N | Limit search results | whatsapp-cli search "photo" --limit 10 |
whatsapp-cli groups | List all groups | whatsapp-cli groups |
whatsapp-cli export <name> <path> | Export chat to file | whatsapp-cli export "John Doe" ./chat.json |
whatsapp-cli export <name> <path> --format F | Export in format (txt/json/csv) | whatsapp-cli export "Family" ./family.csv --format csv |
whatsapp-cli monitor <name> | Monitor a chat for new messages | whatsapp-cli monitor "John Doe" |
whatsapp-cli monitor <name> --interval N | Set poll interval in seconds | whatsapp-cli monitor "John Doe" --interval 10 |
whatsapp-cli auto-reply <name> --message <msg> | Auto-reply to a contact | whatsapp-cli auto-reply "Boss" --message "I'll get back to you soon" |
whatsapp-cli status | Show WhatsApp connection status | whatsapp-cli status |
Interpret the user's natural language and map to the correct command:
whatsapp-cli chatswhatsapp-cli unreadwhatsapp-cli read "John"whatsapp-cli send "John" "hello"whatsapp-cli search "dinner"whatsapp-cli groupswhatsapp-cli export "John" ./john_chat.txtwhatsapp-cli monitor "John"whatsapp-cli auto-reply "John" --message "..."~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/. This is read-only access.whatsapp:// URL scheme, which opens the desktop app. This ensures messages go through official WhatsApp infrastructure.