WhatsApp MCP — MCP-сервер для Claude Code: что делает и установка
MCP-сервер подключает Claude Code к чатам, контактам и сообщениям WhatsApp. Поддерживает поиск, локальную расшифровку голосовых заметок и отправку с подтверждением.
claude mcp add --env WHATSAPP_BRIDGE_HOST=<WHATSAPP_BRIDGE_HOST> --env WHATSAPP_BRIDGE_PORT=<WHATSAPP_BRIDGE_PORT> --env WHATSAPP_VAULT_CRM_PATH=<WHATSAPP_VAULT_CRM_PATH> --env WHATSAPP_WHISPER_BACKEND=<WHATSAPP_WHISPER_BACKEND> --env WHATSAPP_WHISPER_API_KEY=<WHATSAPP_WHISPER_API_KEY> --transport stdio whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcpЧто делает WhatsApp MCP
WhatsApp MCP даёт агенту доступ к чатам, сообщениям и контактам WhatsApp. Он ищет сообщения с учётом акцентов и опечаток, разрешает LID-имена и умеет работать с контекстом CRM из vault Obsidian. Голосовые заметки можно расшифровывать локально через whisper.cpp.
Сервер состоит из Go-моста whatsapp-bridge/ и Python-слоя whatsapp-mcp-server/ на FastMCP. Мост использует whatsmeow, хранит данные в зашифрованной SQLCipher-базе и общается с Python-слоем через REST API. Отправка проходит через черновик и обязательный вызов confirm_send; вызовы инструментов попадают в журнал аудита.
Для подключения нужен одноразовый QR pairing с телефоном и запущенный Go-мост. Без этого шага сервер не сможет подключиться к WhatsApp. Для голосовой расшифровки понадобятся FFmpeg и whisper.cpp; при выборе openai-api нужен WHATSAPP_WHISPER_API_KEY.
Какие задачи решает
- читать чаты и контакты WhatsApp через агента
- искать сообщения с учётом опечаток и акцентов
- расшифровывать голосовые заметки локально
- подготовить сообщение перед отправкой
- добавлять CRM-контекст из vault Obsidian
Примеры запросов агенту
- Найди в WhatsApp сообщения о релизе с учётом опечаток и акцентов.
- Покажи последние сообщения из этого чата и добавь подходящий CRM-контекст из vault.
- Подготовь ответ на последнее сообщение, покажи черновик и отправь его только после
confirm_send.
Как установить WhatsApp MCP
Командой платформы
claude mcp add --env WHATSAPP_BRIDGE_HOST=<WHATSAPP_BRIDGE_HOST> --env WHATSAPP_BRIDGE_PORT=<WHATSAPP_BRIDGE_PORT> --env WHATSAPP_VAULT_CRM_PATH=<WHATSAPP_VAULT_CRM_PATH> --env WHATSAPP_WHISPER_BACKEND=<WHATSAPP_WHISPER_BACKEND> --env WHATSAPP_WHISPER_API_KEY=<WHATSAPP_WHISPER_API_KEY> --transport stdio whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-whatsapp-mcp <команда>
Командой платформы
codex mcp add whatsapp-mcp --env WHATSAPP_BRIDGE_HOST=<WHATSAPP_BRIDGE_HOST> --env WHATSAPP_BRIDGE_PORT=<WHATSAPP_BRIDGE_PORT> --env WHATSAPP_VAULT_CRM_PATH=<WHATSAPP_VAULT_CRM_PATH> --env WHATSAPP_WHISPER_BACKEND=<WHATSAPP_WHISPER_BACKEND> --env WHATSAPP_WHISPER_API_KEY=<WHATSAPP_WHISPER_API_KEY> -- uvx adelaidasofia-whatsapp-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-whatsapp-mcp <команда>
Файл настроек
{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
],
"env": {
"WHATSAPP_BRIDGE_HOST": "<WHATSAPP_BRIDGE_HOST>",
"WHATSAPP_BRIDGE_PORT": "<WHATSAPP_BRIDGE_PORT>",
"WHATSAPP_VAULT_CRM_PATH": "<WHATSAPP_VAULT_CRM_PATH>",
"WHATSAPP_WHISPER_BACKEND": "<WHATSAPP_WHISPER_BACKEND>",
"WHATSAPP_WHISPER_API_KEY": "<WHATSAPP_WHISPER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-whatsapp-mcp <команда>
Файл настроек
{
"servers": {
"whatsapp-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
],
"env": {
"WHATSAPP_BRIDGE_HOST": "<WHATSAPP_BRIDGE_HOST>",
"WHATSAPP_BRIDGE_PORT": "<WHATSAPP_BRIDGE_PORT>",
"WHATSAPP_VAULT_CRM_PATH": "<WHATSAPP_VAULT_CRM_PATH>",
"WHATSAPP_WHISPER_BACKEND": "<WHATSAPP_WHISPER_BACKEND>",
"WHATSAPP_WHISPER_API_KEY": "<WHATSAPP_WHISPER_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-whatsapp-mcp <команда>
Командой платформы
gemini mcp add -e WHATSAPP_BRIDGE_HOST=<WHATSAPP_BRIDGE_HOST> -e WHATSAPP_BRIDGE_PORT=<WHATSAPP_BRIDGE_PORT> -e WHATSAPP_VAULT_CRM_PATH=<WHATSAPP_VAULT_CRM_PATH> -e WHATSAPP_WHISPER_BACKEND=<WHATSAPP_WHISPER_BACKEND> -e WHATSAPP_WHISPER_API_KEY=<WHATSAPP_WHISPER_API_KEY> whatsapp-mcp uvx adelaidasofia-whatsapp-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from adelaidasofia-whatsapp-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о WhatsApp MCP
Как установить WhatsApp MCP в Claude Code?
Выполните claude mcp add whatsapp-mcp -e WHATSAPP_WHISPER_API_KEY=<WHATSAPP_WHISPER_API_KEY> -- uvx adelaidasofia-whatsapp-mcp.
Что делает WhatsApp MCP?
Он подключает Claude Code к чатам, сообщениям и контактам WhatsApp, даёт поиск и работу с голосовыми заметками. Текстовые сообщения, реакции и ответы с цитатой проходят через обязательное подтверждение confirm_send.
Что нужно для подключения WhatsApp MCP?
Нужно запустить Go-мост и один раз связать его с телефоном через QR pairing. FFmpeg и whisper.cpp нужны только для расшифровки голосовых заметок, а для openai-api требуется WHATSAPP_WHISPER_API_KEY.
