Mailbox — MCP-сервер для Claude Code: почта IMAP/SMTP для агента
Даёт агенту доступ к почте через IMAP и SMTP: читать, раскладывать по папкам, готовить черновики и отправлять письма. Права ограничиваются токеном.
Открыть на GitHubЧто делает Mailbox
Сервис поднимается в Docker и отдаёт HTTP API вместе с MCP-эндпоинтом на /mcp на том же порту. Аккаунтов может быть несколько, у каждого свой набор настроек в config.yaml. Тела писем и черновики остаются на IMAP — в локальной SQLite лежит только служебное: записи аудита, счётчики отправок, чекпоинты, метаданные вебхуков.
Доступ настраивается токенами. Токену с правами read, draft и organize инструменты удаления и отправки не показываются вовсе. Удаление по умолчанию переносит письмо в Trash, стереть насовсем можно только с правом delete и только из Trash. Черновик агент готовит в два шага: письмо собирается, отправляет его человек или токен с правом send. На отправку действует часовой лимит, есть dry-run и проверка, что адрес отправителя входит в настроенные идентичности.
Перед запуском нужен config.yaml и .env: пароли и токены из openssl rand -hex 32. Обоим файлам ставят chmod 600, конфиг монтируют в контейнер только для чтения. Для персистентности монтируйте том в /var/lib/mailboxd — без него аудит и счётчики не переживут рестарт. Внутри Python-стек: imaplib, smtplib, FastAPI, официальный MCP SDK и nh3 для очистки HTML.
Какие задачи решает
- показать агенту свежие письма из общего ящика
- разложить входящие по папкам и меткам
- подготовить черновик ответа на письмо клиента
- отправить письмо с проверенного адреса в рамках лимита
- проверить SPF, DKIM и DMARC у подозрительного письма
Примеры запросов агенту
- Покажи последние пять писем во входящих и перескажи, что в них.
- Найди письма от бухгалтерии за эту неделю и перенеси их в папку
finance. - Собери черновик ответа на последнее письмо клиента, отправлять пока не надо.
Как установить Mailbox
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Mailbox
Как установить Mailbox в Claude Code?
Готовой команды установки нет. Скопируйте config.example.yaml в config.yaml и .env.example в .env, заполните аккаунты и токены, затем запустите контейнер: `docker run --rm -p 127.0.0.1:8000:8000 --env-file .env -v "$PWD/config.yaml:/etc/mailboxd/config.yaml:ro" -v mailboxd-state:/var/lib/mailboxd psyb0t/mailbox:latest. После этого подключите агент к эндпоинту /mcp`.
Что делает Mailbox?
Работает как шлюз между агентом и почтовыми ящиками: читает письма, ищет по ним, двигает в папки, готовит черновики и отправляет. Всё это через HTTP API и MCP, с правами на уровне токена.
Можно ли разрешить агенту только чтение?
Да. Токен без прав draft, organize, send и delete видит только инструменты чтения. Отправка дополнительно ограничена часовым лимитом и списком настроенных адресов отправителя.
