marcelrgberger/whatsapp-cli

3 stars · Last commit 2026-03-31

Claude Code plugin: Control WhatsApp from Claude — read chats, send messages, search, auto-reply, export conversations, monitor in real-time. macOS only.

README preview

# whatsapp-cli

Claude Code plugin for full control over **WhatsApp** on macOS. Read chats, send messages to individuals and groups, search conversations, auto-reply with AI, monitor in real-time, and export chat history.

## Features

- **Read chats** — list conversations, unread messages, starred messages
- **Send messages** — to contacts and groups (auto-detects group JIDs)
- **Search** — full-text search across all conversations
- **Groups** — list groups, members, group info
- **Contacts** — list, search, resolve names to JIDs
- **Auto-reply** — AI-powered auto-reply using Claude as response generator
- **Monitor** — watch chats in real-time for new messages
- **Export** — export chat history to TXT, JSON, or CSV; export media files
- **Interactive REPL** — full-featured REPL with history and styled prompts

## Requirements

- **macOS** (uses WhatsApp's local SQLite database)
- **WhatsApp desktop app** installed and logged in

View full repository on GitHub →