WhatsApp MCP от Very Good Plugins

Установка

Работает в

• Claude Desktop
• Cursor
• SourceCraft
• Koda
• Coddy

Ручная установка

git clone https://github.com/verygoodplugins/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge
go run .

Что делает

Форк WhatsApp MCP от Very Good Plugins соединяет Claude или Cursor с вашим личным аккаунтом WhatsApp. Работа делится на две части. Мост на Go подключается к WhatsApp как связанное устройство, показывает QR-код для входа и сохраняет доступную историю переписки в локальную базу SQLite. MCP-сервер на Python читает эту базу и через мост отправляет сообщения. Результаты вызовов поступают в контекст агента. У сервера есть инструменты для контактов (`search_contacts`, `get_contact`), чатов (`list_chats`, `get_chat`, `get_direct_chat_by_contact`, `get_contact_chats`, `get_last_interaction`) и сообщений (`list_messages`, `get_message_context`). Отправка охватывает текст с цитированием и упоминаниями (`send_message`), файлы (`send_file`), голосовые (`send_audio_message`) и реакции (`send_reaction`). Метки о прочтении выставляются только явной командой `mark_messages_read`. Входящие медиафайлы скачиваются через `download_media`, а `view_media` отдает картинку или первый кадр видео прямо в чат для клиентов без доступа к файлам. `transcribe_audio` расшифровывает голосовые локально через `whisper.cpp` или через совместимую конечную точку и записывает текст в сообщение. Звонки попадают в локальную таблицу, а входящие сообщения можно пересылать вебхуком.

Для кого. Для тех, кто хочет разбирать свою переписку в WhatsApp и отвечать на сообщения через Claude Desktop или Cursor и готов собрать мост на Go.

Пример запроса к агенту

Найди в чате с Алексеем последнее сообщение про договор, покажи пять сообщений до и после, а потом подготовь ответ, но не отправляй без моего подтверждения

MCP

Транспорт

stdio, http, sse

Авторизация

не нужна

Ограничения

Нужны Go 1.26, Python 3.11 или новее и `uv`. Мост и MCP-сервер запускаются из общего клона, а WhatsApp связывается с ним по QR-коду. Для локального распознавания голоса нужны `whisper.cpp`, модель и FFmpeg. Внешний сервис расшифровки получает исходное аудио.

Шифрование WhatsApp при передаче не защищает локальную историю SQLite. Прочитанную переписку получает модель агента. REST-интерфейс моста требует токен, но сетевые режимы самого MCP не имеют встроенной авторизации. Основной вариант установки использует `stdio`.

Вебхук включен по умолчанию и направлен на локальный адрес. Если задаете `WEBHOOK_URL`, указывайте доверенный сервис: вместе с сообщениями ему передается токен моста. Отправка сообщений не имеет отдельного подтверждения в сервере. Лицензия кода MIT.

Как отключить. Остановите мост на Go и уберите блок `whatsapp` из конфигурации Claude Desktop или Cursor. Чтобы отвязать устройство, откройте в приложении WhatsApp список связанных устройств и удалите его. Локальные базы лежат в папке `whatsapp-bridge/store/`.

Коротко о README

Форк сохраняет схему исходного проекта Luke Harries с мостом Go и сервером Python. Дополнения Very Good Plugins включают работу с реакциями, явные отметки прочтения и просмотр медиа в клиентах без доступа к файловой системе.