WhatsApp MCP для macOS

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

Возможности

• Поиск контактов — находите любого человека по имени или номеру телефона

• Чтение сообщений — получайте историю чатов с фильтрацией по дате и поиском

• Список чатов — просматривайте недавние беседы с количеством непрочитанных сообщений

• Отправка сообщений — отвечайте напрямую через Claude (с аутентификацией по QR-коду)

• Входящие в реальном времени — получайте сообщения по мере их поступления

Related MCP server: claude-whatsapp-mcp

Требования

• 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

1. Откройте файл конфигурации:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Если он не существует, создайте его.

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

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

3. Перезапустите Claude Desktop (Cmd+Q, затем откройте снова)

4. Найдите значок инструментов MCP (🔨) в поле ввода чата — нажмите на него, чтобы убедиться, что "whatsapp" в списке

5. Начните общение:

   • "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"

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

1. Запустите мост WhatsApp:

   cd bridge && npm install && npm start

2. Попросите Claude проверить соединение:

   • "Check WhatsApp status"

3. Если появится QR-код, откройте URL данных в браузере и отсканируйте его телефоном

4. После подключения вы сможете отправлять сообщения:

   • "Send a message to Mom saying I'll be late"

   • "Reply to John with 'sounds good'"

Инструменты

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

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