WhatsApp MCP для macOS

Сервер Model Context Protocol, который подключает Claude к вашему WhatsApp. Читайте сообщения, ищите контакты, отправляйте ответы — и всё это через естественный диалог.

Возможности

Поиск контактов — находите любого человека по имени или номеру телефона
Чтение сообщений — получайте историю чатов с фильтрацией по дате и поиском
Список чатов — просматривайте недавние беседы с количеством непрочитанных сообщений
Отправка сообщений — отвечайте напрямую через Claude (с аутентификацией по QR-коду)
Входящие в реальном времени — получайте сообщения по мере их поступления

Требования

macOS с установленным и авторизованным приложением WhatsApp для рабочего стола
Python 3.10+
Node.js 18+ (для отправки сообщений)

Установка

Использование pip

pip install whatsapp-mcp-macos

Из исходного кода

git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp
pip install -e .

Подключение к Claude Desktop

Откройте файл конфигурации:
```
open ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
Если он не существует, создайте его.

Добавьте сервер WhatsApp MCP:

{
  "mcpServers": {
    "whatsapp": {
      "command": "python3",
      "args": ["-m", "whatsapp_mcp"]
    }
  }
}

Перезапустите Claude Desktop (Cmd+Q, затем откройте снова)
Найдите значок инструментов MCP (🔨) в поле ввода чата — нажмите на него, чтобы убедиться, что "whatsapp" в списке
Начните общение:
- "Show my recent WhatsApp chats"
- "Search messages for dinner plans"

Подключение к Cursor

Добавьте в .cursor/mcp.json в вашем проекте:

{
  "mcpServers": {
    "whatsapp": {
      "command": "python3",
      "args": ["-m", "whatsapp_mcp"]
    }
  }
}

Перезапустите Cursor и используйте инструменты WhatsApp в AI-чате.

Использование

Чтение сообщений (работает сразу)

Просто спросите Claude:

"Show my recent WhatsApp chats"
"Search for messages about dinner"
"What did John say yesterday?"
"Catch me up on unread messages"

Отправка сообщений (требуется мост)

Запустите мост WhatsApp:
```
cd bridge && npm install && npm start
```
Попросите Claude проверить соединение:
- "Check WhatsApp status"
Если появится QR-код, откройте URL данных в браузере и отсканируйте его телефоном
После подключения вы сможете отправлять сообщения:
- "Send a message to Mom saying I'll be late"
- "Reply to John with 'sounds good'"

Инструменты

Инструмент	Описание	Требуется мост
`whatsapp_status`	Проверка соединения, получение QR при необходимости	Нет
`whatsapp_search_contacts`	Поиск контактов по имени/телефону	Нет
`whatsapp_list_chats`	Список недавних бесед	Нет
`whatsapp_get_messages`	Получение сообщений из чата	Нет
`whatsapp_search_messages`	Поиск по всем чатам	Нет
`whatsapp_unread`	Сводка непрочитанных сообщений	Нет
`whatsapp_send`	Отправка сообщения	Да
`whatsapp_incoming`	Получение входящих сообщений в реальном времени	Да

Как это работает

Claude ──MCP──▶ WhatsApp MCP Server
                       │
                       ├──▶ Local SQLite DBs (read messages)
                       │    ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/
                       │
                       └──▶ WhatsApp Bridge (:3010) ──▶ WhatsApp Web
                            (for sending)

Операции чтения запрашивают локальную базу данных WhatsApp напрямую — это быстро и работает офлайн.

Операции отправки проходят через мост, который подключается к WhatsApp Web с использованием Baileys.

Разработка

# Clone
git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp

# Install in dev mode
pip install -e ".[dev]"

# Run server
python -m whatsapp_mcp

Конфиденциальность

Все данные остаются локальными — сообщения считываются из вашей собственной базы данных WhatsApp
Никакие данные не отправляются на внешние серверы (за исключением WhatsApp Web при отправке)
Сервер MCP работает локально на вашем компьютере

Лицензия

MIT

WhatsApp MCP for macOS