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

Mail Agent

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

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

Широкий доступ

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

  • Инструмент 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.

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

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

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

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

Что делает

Репозиторий дает два независимых сервиса. 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 часов и ответь на письмо от бухгалтерии, что счет оплачен

MCP

Транспорт
http
Авторизация
не нужна

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

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

Ограничения

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

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

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

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

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

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

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

Обсуждение

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

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

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

MCP-серверРасширенный доступ2Звезды репозитория
Российский стек

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

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

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

Mail.ru MCP Server (Go Production Edition)

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

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

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

MCP Telegram для чтения: агент получает список диалогов и непрочитанные сообщения вашего аккаунта через MTProto, писать от вашего имени он не умеет

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

MCP Telegram с записью: агент отправляет, правит и удаляет сообщения, ищет чаты, ведет черновики и скачивает медиа в вашем аккаунте через MTProto

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

Коротко о README

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

Бейдж для README

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