claude-whatsapp
bycrisandrews· 2 MCP servers
WhatsApp channel plugin for Claude Code — connect your WhatsApp to an AI agent. QR scan, voice transcription, access control, media support.
How to install claude-whatsapp?
crisandrews/claude-whatsapp
$git clone https://github.com/crisandrews/claude-whatsappInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install claude-whatsapp by running `git clone https://github.com/crisandrews/claude-whatsapp`, then use it for the current task and follow its documentation at https://github.com/crisandrews/claude-whatsapp.
README.md
| 1 | <h1 align="center">💬 WhatsApp for Claude Code</h1> |
| 2 | |
| 3 | <p align="center"> |
| 4 | <strong>Your WhatsApp number, powered by Claude Code.</strong> |
| 5 | </p> |
| 6 | |
| 7 | <p align="center"> |
| 8 | <a href="https://github.com/crisandrews/claude-whatsapp/releases"><img src="https://img.shields.io/github/v/release/crisandrews/claude-whatsapp?include_prereleases&style=for-the-badge&color=25D366" alt="Release"></a> |
| 9 | <a href="https://github.com/crisandrews/claude-whatsapp/stargazers"><img src="https://img.shields.io/github/stars/crisandrews/claude-whatsapp?style=for-the-badge&color=blue" alt="Stars"></a> |
| 10 | <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/crisandrews/claude-whatsapp/main/.github/clone-count.json&style=for-the-badge" alt="Clones"> |
| 11 | <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License"></a> |
| 12 | <img src="https://img.shields.io/badge/node-%E2%89%A5%2018-blue?style=for-the-badge&logo=node.js&logoColor=white" alt="Node ≥ 18"> |
| 13 | <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-blue?style=for-the-badge" alt="Platform"> |
| 14 | </p> |
| 15 | |
| 16 | <p align="center"> |
| 17 | <a href="#quick-setup">Quick Setup</a> · |
| 18 | <a href="#features">Features</a> · |
| 19 | <a href="#access-control">Access</a> · |
| 20 | <a href="#documentation">Docs</a> · |
| 21 | <a href="#going-further">Going further</a> · |
| 22 | <a href="https://github.com/crisandrews/claude-whatsapp/issues">Issues</a> |
| 23 | </p> |
| 24 | |
| 25 | --- |
| 26 | |
| 27 | With Anthropic's recent policy changes, many users lost access to their AI agents through messaging platforms. While official channel plugins exist for [Telegram](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) and Instagram, **WhatsApp — the world's most used messaging app — had no solution.** |
| 28 | |
| 29 | This plugin fills that gap. It connects your WhatsApp number directly to Claude Code, turning it into a fully functional AI agent that responds through WhatsApp. |
| 30 | |
| 31 | ## [Highlights](#highlights) |
| 32 | |
| 33 | - **[Native WhatsApp channel](#quick-setup)** — scan a QR (or use a pairing code on headless servers), pair your contacts, start chatting with Claude. |
| 34 | - **[Access control](#access-control)** — pairing codes, allowlist, group gating with `requireMention`, plus per-chat history scope (each chat sees its own history by default; designated owners read all). Nobody talks to your agent without permission, and no chat reads another's history. |
| 35 | - **[Permission relay](#permission-requests-over-whatsapp)** — when Claude wants to run a tool, get the prompt on WhatsApp; approve or deny with a 👍 reaction or `yes <id>` reply. |
| 36 | - **[Local search, export, and discovery](#search-history-and-export)** — every message indexed locally; full-text search, contact and chat discovery, message-context lookup, request older messages from WhatsApp, dump chats to markdown / jsonl / csv. |
| 37 | - **[Voice transcription](#voice-transcription-optional)** — local Whisper by default (no API keys, 99+ languages); optional cloud providers (Groq / OpenAI) for higher quality on slower hardware. |
| 38 | - **[Media pipeline](#media)** — inbound images, audio, video, and documents auto-downloaded for Claude to read. |
| 39 | - **[Reply shaping](#reply-shaping)** — paragraph-aware chunking, optional ack reaction, auto-document for long replies, message editing without push notifications. |
| 40 | - **[Inbound debouncing](#inbound-debouncing)** — rapid-fire texts from the same sender are batched into a single agent turn, so Claude stops answering mid-thought when the user is still typing. |
| 41 | - **[Autonomous mode + web browsing](#autonomous-mode--web-browsing)** — combine with `--chrome` for a fully agentic WhatsApp assistant. |
| 42 | - **[Always-on](#always-on-run-as-a-background-service)** — launchd, systemd, or Task Scheduler recipes included. |
| 43 | - **[Multiple agents](#multiple-agents)** — run separate numbers from separate folders, each isolated. |
| 44 | |
| 45 | ## [Prerequisites](#prerequisites) |
| 46 | |
| 47 | - [Node.js](https://nodejs.org/) v18+ |
| 48 | |
| 49 | ## [Quick Setup](#quick-setup) |
| 50 | |
| 51 | **1. Create a folder for your WhatsApp agent.** |
| 52 | |
| 53 | Each agent lives in its own folder. Create one and open Claude Code there: |
| 54 | |
| 55 | ```sh |
| 56 | mkdir ~/my-whatsapp-agent && cd ~/my-whatsapp-agent |
| 57 | claude |
| 58 | ``` |
| 59 | |
| 60 | **2. Install the plugin.** |
| 61 | |
| 62 | Inside Claude Code, add the marketplace: |
| 63 | |
| 64 | ``` |
| 65 | /plugin marketplace add crisandrews/claude-whatsapp |
| 66 | ``` |
| 67 | |
| 68 | Then install the plugin: |
| 69 | |
| 70 | ``` |
| 71 | /plugin install whatsapp@claude-whatsapp |
| 72 | ``` |
| 73 | |
| 74 | When prompted for scope, select **"Install for you, in this repo only (local scope)"** — this keeps the agent isolated to this folder. |
| 75 | |
| 76 | **3. Close and relaunch with the WhatsApp channel.** |
| 77 | |
| 78 | Exit Claude Code (`/exit` or Ctrl+C), then relaunch: |
| 79 | |
| 80 | ```sh |
| 81 | claude --dangerously-load-development-channels plugin:whatsapp@claude-whatsapp --dangerously-skip-permissions |
| 82 | ``` |
| 83 | |
| 84 | > `--dangerously-skip-permissions` lets the agent run without asking for confirmation on every action — recommended for a smooth experience. First launch installs dependencies in the background (~60-90s). Subsequent launches are instant. |
| 85 | |
| 86 | **4. L |
Related
6 picksType
- cortexScientifically-grounded persistent memory for Claude — local-first, hybrid retrieval, 72 references.Jul 2026
- mcphubA hub server for mcp serversJul 2026
- wecom-bot-mcp-serverWeCom Bot MCP Server - A Python server for WeCom (WeChat Work) bot following the Model Context Protocol (MCP)Jul 2026
- hypertool-mcpDynamically expose tools from proxied servers based on an Agent PersonaOct 2025
- reddit-mcpReddit MCP ServerDec 2025
- agent-bridgeBridge between Claude Code and Codex — bidirectional agent communication via MCP Channel + JSON-RPCJul 2026
