WhatsApp MCP Server
MCP-сервер к личному аккаунту WhatsApp: поиск и чтение переписки, контакты, отправка сообщений и файлов через агента
- 6 866 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Отправляет сообщения и файлы от вашего имени в личном аккаунте WhatsApp
- Читает всю личную переписку, что создает риск утечки при инъекции инструкций
Meta, владелец Facebook, Instagram и WhatsApp, признана в России экстремистской организацией, ее деятельность запрещена.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/whatsapp-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Отправляет сообщения и файлы от вашего имени в личном аккаунте WhatsApp
- Читает всю личную переписку, что создает риск утечки при инъекции инструкций
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к личному аккаунту WhatsApp через многоустройственный веб-API на базе библиотеки whatsmeow. Он состоит из двух частей: мост на Go проходит авторизацию по QR-коду и хранит историю сообщений в локальной базе SQLite, а сервер на Python отдает агенту инструменты MCP. Агент может искать по контактам и переписке, читать сообщения с контекстом, отправлять текст в личные чаты и группы, слать изображения, видео, документы и голосовые, а также скачивать вложения. Сами сообщения лежат на вашей машине и попадают в модель только когда агент обращается к ним через вызов инструмента.
Для кого. Для тех, кто хочет работать со своей перепиской WhatsApp из агента: поддержки, продаж, личной автоматизации.
Подходит, если
- Нужно найти и прочитать сообщения или вложения в личных чатах через агента
- Нужно отправить сообщение, файл или голосовое контакту или в группу
- Нужно свести историю переписки с человеком без ручного листания
Не подходит, если
- Нужен официальный бизнес-канал WhatsApp Business API, а не личный аккаунт
- Нельзя привязывать личный номер как дополнительное устройство
Пример запроса к агенту
Найди последнюю переписку с Анной и отправь ей сообщение, что встреча переносится на завтраMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Работает только с личным аккаунтом через привязку устройства, официальный бизнес-канал не используется. Нужны Go и Python, мост и сервер должны быть запущены одновременно. Примерно раз в 20 дней требуется повторная авторизация по QR-коду, WhatsApp ограничивает число привязанных устройств. Голосовые в формате WhatsApp требуют FFmpeg. Автор напоминает про риск утечки данных через инъекцию инструкций: агент с доступом к переписке и к отправке сообщений может стать каналом утечки, если ему подсунуть вредоносный текст.
Как отключить. Уберите блок whatsapp из конфигурации MCP агента и остановите мост на Go. Чтобы отвязать устройство, откройте на телефоне WhatsApp, раздел «Связанные устройства», и удалите сессию. Локальные базы можно удалить из папки whatsapp-bridge/store.
Частые вопросы
Где хранятся сообщения?
В локальной базе SQLite в папке whatsapp-bridge/store. В модель они попадают только когда агент читает их через инструмент.
Это официальный WhatsApp Business API?
Нет. Сервер подключается к личному аккаунту через многоустройственный веб-API, как обычное связанное устройство.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыWhatsApp MCP от Very Good Plugins
WhatsApp MCP by Very Good Plugins
MCP-сервер к личному WhatsApp: чтение и поиск переписки, отправка текста и файлов, реакции, голосовые и расшифровка
MCP-сервер читает историю вашего WhatsApp через связанное устройство, чтобы агент находил сообщения и готовил сводки.
MCP-сервер для macOS: агент читает, ищет и отправляет сообщения в приложении Сообщения на вашем Mac
Локальный MCP-сервер для Mac и Windows: агент работает с почтой, мессенджерами, календарем и файлами.
Go-утилита с JSON-ответами: агент читает чаты WhatsApp, ищет сообщения и контакты и отправляет тексты от вашего номера
MCP-сервер на Telethon: агент читает и отправляет сообщения, управляет чатами, контактами и папками вашего аккаунта Telegram
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| WhatsApp MCP Server (эта карточка) | нет | не нужна | 6 866 | |
| Instagram MCP | нет | API-ключ | 78 | управление бизнес-аккаунтом Instagram: публикации, комментарии, аналитика |
| Facebook MCP | нет | API-ключ | 7 | чтение публичных страниц Facebook через платный API HasData |
Коротко о README
README описывает установку из двух шагов: мост на Go, который подключается к WhatsApp, проходит авторизацию по QR-коду и ведет локальную базу SQLite, и сервер MCP на Python. Дальше приводится JSON-конфигурация для Claude Desktop и Cursor с путями к uv и к папке сервера. Перечислены инструменты: поиск контактов и чатов, чтение сообщений и их контекста, отправка сообщений, файлов и голосовых, скачивание вложений. Отдельно разобраны сборка под Windows с CGO, обработка медиа и типичные проблемы с авторизацией. Лицензия MIT.