verygoodplugins/whatsapp-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер WhatsApp MCP — подключите Claude к WhatsApp для чтения и отправки сообщений
Обзор
Сервер Model Context Protocol (MCP) для WhatsApp, позволяющий Claude читать и отправлять сообщения WhatsApp. Изначально создан Люком Харрисом. Поддерживается очень хорошими плагинами. Демонстрация продукта, созданная с помощью Remotion с использованием смоделированных данных. - : Поиск и чтение личных сообщений WhatsApp (текст, изображения, видео, документы, аудио) - : Поиск контактов по имени или номеру телефона в sender_display формате ("Имя (телефон)") - : Отправка текстовых сообщений отдельным лицам или группам - : Отправка и загрузка изображений, видео, документов и голосовых сообщений - : Захват входящих голосовых/видеозвонков в локальную таблицу SQLite (живой, 1:1 и группа) - : Пересылка входящих сообщений на внешние сервисы - : Все сообщения, хранящиеся локально в SQLite — отправляются в Claude только при разрешении - Go 1.25+ - Python 3.11+ - менеджер пакетов uv - Claude Desktop или Cursor - FFmpeg (опционально, для конвертации голосовых сообщений) При первом запуске мост печатает и хранит локальный токен REST API по адресу whatsapp-bridge/store/.bridge-token.
Обзор (машинный перевод)
Сервер Model Context Protocol (MCP) для WhatsApp, позволяющий Claude читать и отправлять сообщения WhatsApp.
Изначально создан Люком Харрисом. Поддерживается очень хорошими плагинами.
Смотрите видео с демонстрацией WhatsApp MCP
Демонстрация продукта, созданная с помощью Remotion с использованием смоделированных данных.
Особенности
- Управление сообщениями: Поиск и чтение личных сообщений WhatsApp (текст, изображения, видео, документы, аудио)
- Поиск контактов: Поиск контактов по имени или номеру телефона с форматом
sender_display(“Имя (телефон)”) - Отправлять сообщения: Отправлять текстовые сообщения отдельным лицам или группам
- Квитанции о прочитании: Явно отмечайте выбранные сообщения как прочитанные на связанных устройствах
- Поддержка медиа: Отправка и загрузка изображений, видео, документов и голосовых сообщений
- История звонков: Запись входящих голосовых/видеозвонков в локальную таблицу SQLite (живую, 1:1 и группу)
- Интеграция с Webhook: Пересылка входящих сообщений на внешние сервисы
- Локальное хранилище: все сообщения хранятся локально в SQLite — отправляются в Claude только при разрешении
Установка
Требования
- Go 1.26+
- Python 3.11+
- Менеджер пакетов UV
- Claude Desktop или Курсор
- FFmpeg (опционально, для преобразования голосовых сообщений)
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
README
Показан фрагмент оригинального README. Открыть оригинал.
WhatsApp MCP Server
A Model Context Protocol (MCP) server for WhatsApp, enabling Claude to read and send WhatsApp messages.
Originally created by Luke Harries. Maintained by Very Good Plugins.
Watch the WhatsApp MCP demo video
Product demo generated with Remotion using simulated data.
Features
- Message Management: Search and read personal WhatsApp messages (text, images, videos, documents, audio)
- Contact Search: Search contacts by name or phone number with
sender_displayformat (“Name (phone)”) - Send Messages: Send text messages to individuals or groups
- Read Receipts: Explicitly mark selected messages as read across linked devices
- Media Support: Send and download images, videos, documents, and voice messages
- Call History: Capture incoming voice/video calls into a local SQLite table (live, 1:1 and group)
- Webhook Integration: Forward incoming messages to external services
- Local Storage: All messages stored locally in SQLite - only sent to Claude when you allow it
Installation
Prerequisites
- Go 1.26+
- Python 3.11+
- uv package manager
- Claude Desktop or Cursor
- FFmpeg (optional, for voice message conversion)
Intel macOS: patched cryptography releases no longer provide Intel Mac
wheels, so installation may compile this dependency from source. Install the
Xcode Command Line Tools (xcode-select --install) and, with Homebrew,
brew install rust openssl@3 pkg-config. Then install the Python dependencies:
cd whatsapp-mcp-server
OPENSSL_DIR="$(brew --prefix openssl@3)" uv sync
Use a Rust toolchain supported by the installed cryptography release; see its
source-build instructions.
Keep the patched dependency rather than restoring the old vulnerable version pin.
Quick Start
-
Clone the repository
git clone https://github.com/verygoodplugins/whatsapp-mcp.git cd whatsapp-mcp -
Start the WhatsApp bridge
cd whatsapp-bridge go run .On first start, the bridge prints and stores a local REST API token at
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"whatsapp": {
"command": "uv",
"args": [
"--directory",
"/path/to/whatsapp-mcp/whatsapp-mcp-server",
"run",
"main.py"
]
}
}
}