Open Agent Email MCP

Установка

Работает в

• Claude Code
• Cursor
• SourceCraft
• Koda
• Coddy

Ручная установка

git clone https://github.com/Anil-matcha/open-agent-email.git && cd open-agent-email && ./scripts/dev.sh

Что делает

Open Agent Email — сервер на Python, который выдает ИИ-агентам настоящие почтовые адреса. Запускается скриптом `./scripts/dev.sh` или через Docker Compose. При первом старте он создает ключ администратора и ключ шифрования, поднимает API на порту 8000 и приемник SMTP на порту 2525. Администратор заводит ящик агента и ключ доступа к нему, а дальше агент читает письма, отвечает в той же ветке, пересылает их и пишет новые через REST, клиенты на Python и TypeScript, командную строку `oae` или MCP. Входящее письмо принимает SMTP-приемник, и сначала его разбирает сканер угроз. Он ищет в тексте и HTML команды вроде «игнорируй прошлые инструкции», скрытый текст (`display:none`, нулевой размер шрифта), служебные разделители ChatML и утечку данных через markdown-картинки, а base64 разворачивает и проверяет. Подозрительное письмо попадает в очередь на ручное одобрение. Параметр `hitl_enabled` включен по умолчанию, и тогда в очередь идут и исходящие письма: человек одобряет или отклоняет их в панели управления либо по ссылке в письме. Исходящие уходят через внешний SMTP-релей, например Amazon SES, Resend, SendGrid, Postmark или Gmail, а письма между ящиками одного сервера релея не требуют. MCP-сервер доступен по адресу `/mcp/rpc` и принимает тот же ключ в заголовке Authorization. Инструментов 96, набор зависит от ключа: ключ ящика работает только со своим ящиком, ключ администратора управляет ящиками, доменами, ключами и настройками сервера, а ключ проверяющего видит только очередь одобрений. Инструмент `get_recent_otp` достает из свежих писем код подтверждения из 4–8 цифр и не отдает тело письма.

Для кого. Для разработчиков, которые хотят дать агенту в Claude Code или Cursor собственный почтовый адрес для регистраций, переписки и уведомлений и готовы сами развернуть и поддерживать сервер.

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

Подними Open Agent Email локально, создай ящик hello@agents.example.com с одобрением исходящих и подключи его к Claude Code по MCP

MCP

Транспорт

http

Авторизация

API-ключ

Ограничения

• В репозитории нет файла лицензии, хотя в описании названа Apache 2.0. Автор не указал лицензию, права на использование и копирование не определены, уточните у автора.
• Проект в активной разработке. Автор предупреждает, что почтовый путь мало проверен на живых провайдерах, и просит прочитать руководство по эксплуатации до подключения реального трафика. Отметки о проверке от 15 октября 2026 года сняты на ноутбуке, не на стенде: 757 тестов прошли и на SQLite, и на PostgreSQL 16.15.
• По умолчанию данные лежат в SQLite внутри тома Docker `oae-data`. Там же хранится ключ шифрования паролей релея, секретов вебхуков и ключей DKIM: если потерять том вместе с ключом, сохраненные секреты не прочитать.
• Чтобы принимать письма из интернета, порт 2525 нужно пробросить на порт 25, а для отправки наружу настроить релей в разделе настроек.
• Клиент для TypeScript собирается из каталога `sdks/typescript` репозитория, в пакетном реестре автор его не публикует. Клиент для Python ставится из каталога `sdks/python`.

Как отключить. Уберите подключение к MCP командой `claude mcp remove open-agent-email` или удалите раздел `open-agent-email` из `.cursor/mcp.json`. Ключ ящика отзовите в панели управления, чтобы он перестал работать. Сервер в Docker останавливает `docker compose down`, а том `oae-data` с почтой, ключами и базой остается на диске, пока вы не удалите его отдельно.

Коротко о README

В репозитории лежат серверная часть, панель управления на Next.js, клиенты для Python и TypeScript и пример слушателя событий по WebSocket. Документация состоит из быстрого старта, справочника с каталогом MCP-инструментов, руководства по эксплуатации, описания кодов ошибок и правил мониторинга для Prometheus. Тестов много: серверные проверяют контракт OpenAPI и совпадение MCP с REST, клиентские покрывают вебхуки и постраничную выдачу. Руководство по эксплуатации заканчивается таблицей упражнений, которые нужно пройти на тестовом стенде до включения настоящей почты.