MCP-сервер почты Mail.ru

mailru-mcp

MCP-сервер для почты Mail.ru: чтение, поиск, сортировка по папкам и архивация с обходом особенностей Mail.ru по IMAP

  • 2 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Может массово перемещать, архивировать и удалять письма в корзину
  • Отправка ответа возможна только на белый список адресов, но черновики и архивация работают без него
Все причины и проверки
Российский стек

braflovskikyle40-debug/mailru-mcp

Установка

Сервисы

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

pip install mcp

Единственная внешняя зависимость, остальное из стандартной библиотеки Python.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Может массово перемещать, архивировать и удалять письма в корзину
  • Отправка ответа возможна только на белый список адресов, но черновики и архивация работают без него

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

Что делает

Сервер подключается к почте Mail.ru по IMAP паролем для внешних приложений и дает агенту инструменты для списка и создания папок, подсчета и вывода писем с фильтрами по времени и отправителю, чтения полного текста письма, переноса и массовой архивации старых писем, удаления в корзину и подготовки ответа. Отдельно решены типичные проблемы Mail.ru: кириллические имена папок в модифицированном UTF-7, обрыв соединения при массовом чтении писем (партиями по 200) и переподключение при разрыве долгих сессий. Ответ на письмо можно только сохранить в черновики или отправить исключительно на адреса из белого списка, без списка отправка отключена полностью.

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

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

  • Нужно разобрать тысячи накопившихся писем по папкам одной командой
  • Нужно найти и прочитать письма от конкретного отправителя за период
  • Нужно подготовить ответ в черновики или ограничить отправку узким списком адресов

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

  • Нужна отправка писем на произвольные адреса без ограничений: сервер намеренно это блокирует без явного белого списка
  • Нужен доступ к календарю или контактам Mail.ru: сервер работает только с почтой

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

Создай папку Магазины и перенеси туда все письма от Ozon и Wildberries за последний год

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

MAILRU_EMAIL обязательная
Адрес почты Mail.ru.
MAILRU_PASSWORD обязательная, секрет
Пароль для внешних приложений, создается в настройках безопасности Mail.ru.
MAILRU_ALLOWED_RECIPIENTS
Список адресов или доменов через запятую, на которые разрешена отправка через send_reply.

Ограничения

Проект совсем свежий, один автор, без релизов и упаковки, ставится клонированием репозитория. Нужен пароль для внешних приложений, а не основной пароль аккаунта. При массовом переносе писем возможны дубли из-за повторного копирования после обрыва связи, автор предупреждает об этом честно.

Как отключить. Удалите запись mailru из конфигурации MCP клиента и остановите процесс сервера.

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

Можно ли безвозвратно удалить письма?

Нет, delete_emails переносит письма в корзину, как обычная кнопка удаления, ошибку можно исправить.

Как защищена отправка писем от подмены инструкций из текста письма?

send_reply отправляет только на адреса или домены из переменной MAILRU_ALLOWED_RECIPIENTS, без нее отправка не работает совсем, а draft_reply вообще ничего не отправляет.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Небольшой read-only MCP-сервер для почты Mail.ru: список писем, чтение, поиск и папки без возможности отправки или удаления

MCP-серверШирокий доступ

MCP-сервер для почты Mail.ru

Mail.ru MCP Server (Go Production Edition)

Российский стек

MCP-сервер на Go для почты, SMTP и облака Mail.ru с подтверждением человеком перед отправкой письма или изменением файлов

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

MCP-сервер для почты Mail.ru в Claude.ai и отдельный Telegram-бот, который каждые 15 минут проверяет ящик и присылает уведомления о важных письмах

MCP-серверШирокий доступ
Российский стек

Скилл для чтения и поиска почты по IMAP через CLI myl: Gmail, Яндекс Почта, Mail.ru, автообнаружение других провайдеров

СкиллМинимальный доступ2Звезды репозитория

MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков

MCP-серверШирокий доступ393Звезды репозитория

Коротко о README

README подробно объясняет, зачем нужен отдельный сервер для Mail.ru, дает таблицу из десяти инструментов, показывает настройку пароля внешнего приложения и конфигурацию Claude Code. Отдельные разделы посвящены обойденным особенностям Mail.ru (кодировка папок, обрывы сессий, дубли при сбоях) и мерам безопасности: письма как данные, а не инструкции, белый список получателей и обратимое удаление. Автор приводит числа из реального теста на своем ящике.

Бейдж для README

Сообщить о проблеме