MCP для почты Mail.ru и Telegram-нотификатор

Mail Agent

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

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

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

  • Инструмент send_reply отправляет письма через SMTP от имени владельца почты
  • Пароль приложения Mail.ru хранится в переменных окружения Railway в открытом виде без секрет-менеджера
Все причины и проверки
Российский стек

garrik24/mail-agent

Установка

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

Текст для агента

Разверни mcp-server как сервис Railway с Root Directory mcp-server и переменными MAIL_IMAP_HOST, MAIL_SMTP_HOST, MAIL_USERNAME и MAIL_PASSWORD (пароль приложения Mail.ru), сгенерируй домен, затем в Claude.ai в Settings, MCP Servers добавь https://<домен>.up.railway.app/mcp.

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

Что делает

Репозиторий дает два независимых сервиса. MCP-сервер на FastMCP и Streamable HTTP дает 7 инструментов для почты Mail.ru по IMAP и SMTP: новые письма за N часов, письма с флагом Important, поиск по тексту, отправителю и дате, полное содержимое письма, структурированные данные для анализа, ответ на письмо через SMTP и список папок ящика. Telegram-нотификатор работает фоновым воркером, раз в 15 минут проверяет почту через IMAP, классифицирует письма по категориям (срочно: госорганы вроде Росреестра и налоговой; важно: финансы и договоры; лид: коммерческие предложения и тендеры), прогоняет через Claude для анализа и присылает уведомление в Telegram, дедуплицируя уже отправленные письма через SQLite. Оба сервиса рассчитаны на деплой на Railway как отдельные сервисы.

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

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

  • Нужно читать, искать и отвечать на письма Mail.ru прямо из чата Claude.ai
  • Нужны уведомления в Telegram о письмах от госорганов, по финансам или новых лидах без постоянной проверки почты
  • Готовы развернуть два сервиса на Railway и хранить пароль приложения Mail.ru в переменных окружения

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

  • Не хотите хранить пароль приложения почты в переменных окружения облачного хостинга: сервисы читают его из ENV в открытом виде
  • Нужна другая почта, а не Mail.ru: IMAP и SMTP адреса захардкожены под imap.mail.ru и smtp.mail.ru
  • Не нужен постоянный фоновый процесс: telegram-notifier рассчитан на непрерывную работу с интервалом проверки

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

Покажи новые письма за последние 6 часов и ответь на письмо от бухгалтерии, что счет оплачен

Ограничения

Лицензии в репозитории нет. Пароль от почты Mail.ru (пароль приложения) хранится в переменных окружения Railway в открытом виде, без секрет-менеджера. Репозиторий содержит папку с готовыми коммерческими предложениями и логотипами реальных компаний (Газпром, Магнит, Ростелеком и другие) как шаблоны для инструмента формирования КП, учтите это при форке под свои нужды.

Как отключить. Удалите оба сервиса в Railway или остановите их, отзовите пароль приложения Mail.ru и удалите MCP-сервер из настроек Claude.ai.

MCP

Транспорт
http
Авторизация
не нужна
Переменные окружения
Переменные окружения
MAIL_USERNAME
обязательная
Адрес почтового ящика Mail.ru
MAIL_PASSWORD
обязательная, секрет
Пароль приложения Mail.ru для IMAP и SMTP

Проверка безопасности

  • Инструмент send_reply отправляет письма через SMTP от имени владельца почты
  • Пароль приложения Mail.ru хранится в переменных окружения Railway в открытом виде без секрет-менеджера

Коротко о README

README на русском описывает структуру двух сервисов, пошаговый деплой на Railway с созданием GitHub-репозитория, переменные окружения для каждого сервиса, подключение MCP к Claude.ai через URL, таблицу из 7 инструментов MCP и таблицу классификации писем Telegram-нотификатора по категориям срочности.

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

Нужен обычный пароль от почты или пароль приложения?

README указывает пароль приложения Mail.ru, его нужно создавать отдельно в настройках безопасности аккаунта, а не использовать основной пароль.

Обязательны ли оба сервиса?

Нет, MCP-сервер и Telegram-нотификатор независимы и можно развернуть только один из них.

Официальный

Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам

MCP-серверСредний риск46,5 тыс.Звезды репозитория
Выбор редакции

CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие

CLIВысокий риск31,2 тыс.Звезды репозитория
Выбор редакции

Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP

CLIСредний рискБез VPN30,1 тыс.Звезды репозитория
Выбор редакции

Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI

MCP-серверСредний риск28,1 тыс.Звезды репозитория
Foxx AIMCP для почты Mail.ru и Telegram-нотификатор

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.