# WhatsApp MCP

MCP-сервер подключает Claude Code к чатам, контактам и сообщениям WhatsApp. Поддерживает поиск, локальную расшифровку голосовых заметок и отправку с подтверждением.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: adelaidasofia
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/adelaidasofia/whatsapp-mcp
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/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`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `WHATSAPP_BRIDGE_HOST`, `WHATSAPP_BRIDGE_PORT`, `WHATSAPP_VAULT_CRM_PATH`, `WHATSAPP_WHISPER_BACKEND`, `WHATSAPP_WHISPER_API_KEY`, `WHATSAPP_WHISPER_MODEL`, `WHATSAPP_SCRUB_PROMPT_INJECTION`, `WHATSAPP_AUDIT_LOG`, `WHATSAPP_ENCRYPT_DB` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- читать чаты и контакты WhatsApp через агента
- искать сообщения с учётом опечаток и акцентов
- расшифровывать голосовые заметки локально
- подготовить сообщение перед отправкой
- добавлять CRM-контекст из vault Obsidian

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md