MCP-сервер чтения почты Mail.ru
Mail.ru MCP
Небольшой read-only MCP-сервер для почты Mail.ru: список писем, чтение, поиск и папки без возможности отправки или удаления
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все инструменты, кроме отметки прочитанным, только читают почту
- Учетные данные приложения дают доступ на чтение к содержимому писем
Установка
Ручная установка
python -m pip install .Установка из клонированного репозитория в виртуальное окружение.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к почте Mail.ru по IMAP с TLS и дает агенту семь инструментов: список последних или непрочитанных писем, чтение одного письма по стабильному IMAP UID с возможностью не помечать его прочитанным, поиск по теме или отправителю, список папок, массовая отметка всех писем в папке прочитанными, счетчик всех и непрочитанных писем в одной папке и по всем настроенным папкам сразу. Единственный инструмент, который меняет состояние ящика, это mail_mark_all_read, отправка и удаление писем в сервере не реализованы вовсе.
Для кого. Для тех, кто хочет дать агенту безопасный доступ только на чтение к почте Mail.ru без риска отправки или удаления писем.
Подходит, если
- Нужен обзор непрочитанных писем без риска случайно что-то отправить или удалить
- Нужно найти письмо по теме или отправителю и прочитать его, не меняя статус прочитанности
- Нужен подсчет писем по нескольким папкам сразу
Не подходит, если
- Нужно отправлять или удалять письма: сервер это намеренно не делает
- Нужна массовая сортировка по папкам или архивация: таких инструментов здесь нет
Пример запроса к агенту
Найди последние десять писем со словом счет в теме и не меняй их статус прочитанностиОграничения
Проект одного автора, совсем маленький, без релизов и упаковки на PyPI, ставится из исходников. Нужны отдельные данные для внешнего приложения, а не основной пароль аккаунта Mail.ru. Тело письма обрезается до 4000 символов.
Как отключить. Удалите запись mailru из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MAILRU_EMAIL обязательная | Полный адрес почтового ящика для авторизации IMAP. |
| MAILRU_APP_CREDENTIAL обязательная, секрет | Отдельные данные для внешнего приложения из настроек Mail.ru. |
| MAILRU_FOLDERS | Список папок через запятую для mail_count_all, по умолчанию INBOX. |
Проверка безопасности
- Все инструменты, кроме отметки прочитанным, только читают почту
- Учетные данные приложения дают доступ на чтение к содержимому писем
Коротко о README
README на английском и русском описывает семь инструментов, требования к Python и учетным данным, установку через pip, таблицу переменных окружения, пример конфигурации .mcp.json и раздел безопасности: TLS для каждого соединения, данные только из переменных окружения, чтение по умолчанию помечает письмо прочитанным.
Частые вопросы
Может ли сервер отправить письмо?
Нет, отправка и удаление писем в сервере не реализованы, он только читает и организует чтение.
Меняется ли статус письма при чтении?
По умолчанию mail_read помечает письмо прочитанным, но параметр mark_read=false сохраняет исходный статус.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI