WhatsApp MCP Server

MCP-сервер к личному аккаунту WhatsApp: поиск и чтение переписки, контакты, отправка сообщений и файлов через агента

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/whatsapp-mcp-server

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'PATH_TO_UV=<значение PATH_TO_UV>' --env 'PATH_TO_SRC=<значение PATH_TO_SRC>' whatsapp-mcp-server -- uvx --directory ./whatsapp-mcp-server run main.py

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"whatsapp-mcp-server","type":"stdio","command":"uvx","args":["--directory","./whatsapp-mcp-server","run","main.py"],"env":{"PATH_TO_UV":"<значение PATH_TO_UV>","PATH_TO_SRC":"<значение PATH_TO_SRC>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "whatsapp-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add whatsapp-mcp-server --env 'PATH_TO_UV=<значение PATH_TO_UV>' --env 'PATH_TO_SRC=<значение PATH_TO_SRC>' -- uvx --directory ./whatsapp-mcp-server run main.py

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.whatsapp-mcp-server]
command = "uvx"
args = ["--directory", "./whatsapp-mcp-server", "run", "main.py"]
env = { PATH_TO_UV = "<значение PATH_TO_UV>", PATH_TO_SRC = "<значение PATH_TO_SRC>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "whatsapp-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "environment": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "whatsapp-mcp-server": {
      "command": "uvx",
      "args": [
        "--directory",
        "./whatsapp-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "PATH_TO_UV": "<значение PATH_TO_UV>",
        "PATH_TO_SRC": "<значение PATH_TO_SRC>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

PATH_TO_UVобязательная: Path to the uv executable
PATH_TO_SRCобязательная: Path to the whatsapp-mcp source directory

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 7d6a06d.

Текст для агента

Склонируй репозиторий lharries/whatsapp-mcp, запусти мост командой go run main.go в папке whatsapp-bridge и авторизуйся по QR-коду. Затем добавь сервер whatsapp в конфигурацию MCP, указав путь к uv и к папке whatsapp-mcp-server, и перезапусти агента.

Другие способы из описания автора

git clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge
go run main.go

Первый запуск моста покажет QR-код, отсканируйте его в приложении WhatsApp на телефоне. Мост должен работать, пока вы пользуетесь сервером.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключается к личному аккаунту WhatsApp через многоустройственный веб-API на базе библиотеки whatsmeow. Он состоит из двух частей: мост на Go проходит авторизацию по QR-коду и хранит историю сообщений в локальной базе SQLite, а сервер на Python отдает агенту инструменты MCP. Агент может искать по контактам и переписке, читать сообщения с контекстом, отправлять текст в личные чаты и группы, слать изображения, видео, документы и голосовые, а также скачивать вложения. Сами сообщения лежат на вашей машине и попадают в модель только когда агент обращается к ним через вызов инструмента.

Для кого. Для тех, кто хочет работать со своей перепиской WhatsApp из агента: поддержки, продаж, личной автоматизации.

Подходит, если

Нужно найти и прочитать сообщения или вложения в личных чатах через агента
Нужно отправить сообщение, файл или голосовое контакту или в группу
Нужно свести историю переписки с человеком без ручного листания

Не подходит, если

Нужен официальный бизнес-канал WhatsApp Business API, а не личный аккаунт
Нельзя привязывать личный номер как дополнительное устройство

Пример запроса к агенту

Найди последнюю переписку с Анной и отправь ей сообщение, что встреча переносится на завтра

Ограничения

Работает только с личным аккаунтом через привязку устройства, официальный бизнес-канал не используется. Нужны Go и Python, мост и сервер должны быть запущены одновременно. Примерно раз в 20 дней требуется повторная авторизация по QR-коду, WhatsApp ограничивает число привязанных устройств. Голосовые в формате WhatsApp требуют FFmpeg. Автор напоминает про риск утечки данных через инъекцию инструкций: агент с доступом к переписке и к отправке сообщений может стать каналом утечки, если ему подсунуть вредоносный текст.

Как отключить. Уберите блок whatsapp из конфигурации MCP агента и остановите мост на Go. Чтобы отвязать устройство, откройте на телефоне WhatsApp, раздел «Связанные устройства», и удалите сессию. Локальные базы можно удалить из папки whatsapp-bridge/store.

MCP

Транспорт: stdio
Авторизация: не нужна

Проверка безопасности

Отправляет сообщения и файлы от вашего имени в личном аккаунте WhatsApp
Читает всю личную переписку, что создает риск утечки при инъекции инструкций

Коротко о README

README описывает установку из двух шагов: мост на Go, который подключается к WhatsApp, проходит авторизацию по QR-коду и ведет локальную базу SQLite, и сервер MCP на Python. Дальше приводится JSON-конфигурация для Claude Desktop и Cursor с путями к uv и к папке сервера. Перечислены инструменты: поиск контактов и чатов, чтение сообщений и их контекста, отправка сообщений, файлов и голосовых, скачивание вложений. Отдельно разобраны сборка под Windows с CGO, обработка медиа и типичные проблемы с авторизацией. Лицензия MIT.

Частые вопросы

Где хранятся сообщения?

В локальной базе SQLite в папке whatsapp-bridge/store. В модель они попадают только когда агент читает их через инструмент.

Это официальный WhatsApp Business API?

Нет. Сервер подключается к личному аккаунту через многоустройственный веб-API, как обычное связанное устройство.

SiYuan

Официальный

Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам

MCP-серверСредний риск46,5 тыс.

gws

Выбор редакции

CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие

CLIВысокий риск31,2 тыс.

QMD

Выбор редакции

Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP

CLIСредний рискБез VPN30,1 тыс.

Taskmaster

Выбор редакции

Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI

MCP-серверСредний риск28,1 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

SiYuan

gws

QMD

Taskmaster