MCP-сервер почты Mail.ru
mailru-mcp
MCP-сервер для почты Mail.ru: чтение, поиск, сортировка по папкам и архивация с обходом особенностей Mail.ru по IMAP
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может массово перемещать, архивировать и удалять письма в корзину
- Отправка ответа возможна только на белый список адресов, но черновики и архивация работают без него
Установка
Ручная установка
pip install mcpЕдинственная внешняя зависимость, остальное из стандартной библиотеки Python.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к почте Mail.ru по IMAP паролем для внешних приложений и дает агенту инструменты для списка и создания папок, подсчета и вывода писем с фильтрами по времени и отправителю, чтения полного текста письма, переноса и массовой архивации старых писем, удаления в корзину и подготовки ответа. Отдельно решены типичные проблемы Mail.ru: кириллические имена папок в модифицированном UTF-7, обрыв соединения при массовом чтении писем (партиями по 200) и переподключение при разрыве долгих сессий. Ответ на письмо можно только сохранить в черновики или отправить исключительно на адреса из белого списка, без списка отправка отключена полностью.
Для кого. Для тех, у кого почта Mail.ru завалена письмами и нужно поручить агенту разбор, сортировку и архивацию без риска случайной рассылки.
Подходит, если
- Нужно разобрать тысячи накопившихся писем по папкам одной командой
- Нужно найти и прочитать письма от конкретного отправителя за период
- Нужно подготовить ответ в черновики или ограничить отправку узким списком адресов
Не подходит, если
- Нужна отправка писем на произвольные адреса без ограничений: сервер намеренно это блокирует без явного белого списка
- Нужен доступ к календарю или контактам Mail.ru: сервер работает только с почтой
Пример запроса к агенту
Создай папку Магазины и перенеси туда все письма от Ozon и Wildberries за последний годОграничения
Проект совсем свежий, один автор, без релизов и упаковки, ставится клонированием репозитория. Нужен пароль для внешних приложений, а не основной пароль аккаунта. При массовом переносе писем возможны дубли из-за повторного копирования после обрыва связи, автор предупреждает об этом честно.
Как отключить. Удалите запись mailru из конфигурации MCP клиента и остановите процесс сервера.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MAILRU_EMAIL обязательная | Адрес почты Mail.ru. |
| MAILRU_PASSWORD обязательная, секрет | Пароль для внешних приложений, создается в настройках безопасности Mail.ru. |
| MAILRU_ALLOWED_RECIPIENTS | Список адресов или доменов через запятую, на которые разрешена отправка через send_reply. |
Проверка безопасности
- Может массово перемещать, архивировать и удалять письма в корзину
- Отправка ответа возможна только на белый список адресов, но черновики и архивация работают без него
Коротко о README
README подробно объясняет, зачем нужен отдельный сервер для Mail.ru, дает таблицу из десяти инструментов, показывает настройку пароля внешнего приложения и конфигурацию Claude Code. Отдельные разделы посвящены обойденным особенностям Mail.ru (кодировка папок, обрывы сессий, дубли при сбоях) и мерам безопасности: письма как данные, а не инструкции, белый список получателей и обратимое удаление. Автор приводит числа из реального теста на своем ящике.
Частые вопросы
Можно ли безвозвратно удалить письма?
Нет, delete_emails переносит письма в корзину, как обычная кнопка удаления, ошибку можно исправить.
Как защищена отправка писем от подмены инструкций из текста письма?
send_reply отправляет только на адреса или домены из переменной MAILRU_ALLOWED_RECIPIENTS, без нее отправка не работает совсем, а draft_reply вообще ничего не отправляет.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI