Расширенный сервер Model Context Protocol (MCP) для WhatsApp с поверхностями, связанными с набором инструментов, для обмена сообщениями, поиска, СМИ, управления группами, веб-хуков, присутствия и многого другого.

Построен на AdamRussak/whatsapp-mcp (вебхуки, контейнеры), который разветвлял lharries/whatsapp-mcp (оригинал). Распространяется на реакции, редактирование сообщений, опросы, управление группами, присутствие, информационные бюллетени и многое другое.

Что нового (в оригинале)

Оригинальное название: Extended [скрыто] [скрыто] [скрыто] [скрыто] [скрыто] [скрыто] | Инструменты MCP | 12 | 26 по умолчанию / 15 lean | Реакции | - | Отредактировать/удалить сообщения | - | | Управление группой | - |
Опросы | - |
Историческая синхронизация. | Присутствие / Онлайн-статус | - | [править править вики-текст] | Webhooks | - |
Обычные прозвища | - |

Архитектура

Быстрый старт

###Докер (рекомендуется)

###Клод Десктоп / Интеграция курсоров

Добавьте конфигурацию MCP ([T0]) или настройки курсора:

###Безопасность и ворота безопасности (Allowlist)

Чтобы ограничить отправку исходящих сообщений определенным набором разрешенных контактов или групп (полезных для среды разработки или шлюзов конфиденциальности предприятия), установите WHATSAPP_ALLOWLIST_JIDS:

Инструменты MCP

Версия '0.4.

WhatsApp MCP Extended

An extended Model Context Protocol (MCP) server for WhatsApp with a toolset-gated, agent-facing surface for messaging, search, media, group management, webhooks, presence, and more.

Built on AdamRussak/whatsapp-mcp (webhooks, containers) which forked lharries/whatsapp-mcp (original). Extended with reactions, message editing, polls, group management, presence, newsletters, and more.

What’s New (vs Original)

Architecture

┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────────────┐
│   whatsapp-bridge   │     │   whatsapp-mcp      │     │   whatsapp-web-ui   │
│   (Go + whatsmeow)  │◄────│   (Python + MCP)    │     │   (HTML/JS SPA)     │
│   Port: 8080        │     │   Port: 8081        │     │   Port: 8090        │
└─────────────────────┘     └─────────────────────┘     └─────────────────────┘
         │                           │
         ▼                           ▼
    ┌─────────────────────────────────────┐
    │           SQLite (store/)           │
    │  messages.db │ whatsapp.db          │
    └─────────────────────────────────────┘

Quick Start

Docker (Recommended)

git clone https://github.com/felixisaac/whatsapp-mcp-extended
cd whatsapp-mcp-extended

docker network create n8n_n8n_traefik_network
docker-compose up -d

# Scan QR code to authenticate
docker-compose logs -f whatsapp-bridge

Claude Desktop / Cursor Integration

Add to your MCP config (claude_desktop_config.json or Cursor settings):

{
  "mcpServers": {
    "whatsapp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/whatsapp-mcp-extended/whatsapp-mcp-server", "python", "main.py"]
    }
  }
}

Security & Safety Gate (Allowlist)

To restrict outgoing message delivery to a specified set of allowed contacts or groups (useful for dev environments or enterprise privacy gates), set WHATSAPP_ALLOWLIST_JIDS:

# Allow sending only to specific phone numbers or group JIDs (comma-separated)
WHATSAPP_ALLOWLIST_JIDS=1234567890,[email protected],[email protected]

MCP Tools

Version 0.4.0 exposes the full curated MCP surface by default for compatibility. Users who want a leaner agent context can opt into smaller toolsets.

Default toolsets:

WHATSAPP_MCP_TOOLSETS=all

Lean recommended toolsets:

WHATSAPP_MCP_TOOLSETS=core,send,media

Toolsets: