MCP-сервер Яндекс Почты
ymail-mcp
Рабочая почта Яндекса в Claude Code через IMAP: чтение писем, поиск по переписке и черновики ответов без отправки
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только читает почту и создает черновики, отправка писем не реализована
- Пароль приложения хранится локально с проверкой прав доступа к файлу
Установка
Ручная установка
claude mcp add ymail -- /path/to/uv run --directory ~/projects/ymail-mcp ymail-mcpПеред этим выполните git clone и uv sync, путь к uv должен быть полным.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает почтовый ящик Яндекса по IMAP и дает агенту читающие инструменты: список папок, непрочитанные письма, поиск по отправителю, теме, тексту и датам, чтение письма целиком и всей переписки вокруг него. Отдельно есть создание черновика, в том числе ответа, и перемещение письма в корзину. Отправлять письма сервер не умеет: это осознанное решение автора, черновик человек всегда просматривает и отправляет сам. Чтение писем идет через IMAP BODY.PEEK, поэтому письма не помечаются прочитанными. Есть командная строка для проверки без модели и парная утилита ycal для календаря.
Для кого. Для тех, кто ведет рабочую переписку в Яндекс Почте и хочет искать письма, читать треды и готовить ответы через агента.
Подходит, если
- Нужно найти письмо по теме или отправителю и прочитать всю переписку вокруг него
- Нужно подготовить черновик ответа, который потом отправите сами
- Нужно посмотреть непрочитанные письма и разобрать их вместе с агентом
Не подходит, если
- Нужно, чтобы агент сам отправлял письма: сервер это не делает принципиально
- Почта не на Яндексе или пароли приложений в организации запрещены политикой безопасности
Пример запроса к агенту
Найди последнее письмо от бухгалтерии про счет и подготовь черновик ответа с подтверждением оплатыОграничения
Нужен пароль приложения Яндекс ID (обычный пароль от аккаунта не подходит), он создается в разделе Безопасность. Сервер отказывается работать, если файл с паролем читаем не только владельцем. Нужен uv для установки. Отправки писем нет и не планируется как основная функция. Проверено только с Яндексом, для других IMAP-провайдеров код не рассчитан.
Как отключить. Выполните claude mcp remove ymail в Claude Code и отзовите пароль приложения в Яндекс ID при необходимости.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YMAIL_USER обязательная | Адрес почты на Яндексе |
| YMAIL_PASSWORD обязательная, секрет | Пароль приложения, созданный в Яндекс ID |
Проверка безопасности
- Только читает почту и создает черновики, отправка писем не реализована
- Пароль приложения хранится локально с проверкой прав доступа к файлу
Коротко о README
README перечисляет семь инструментов таблицей с пометкой, что они читают, а что изменяет ящик, объясняет получение пароля приложения и хранение его в защищенном файле или переменных окружения. Отдельно описаны грабли: кодировка имен папок IMAP, необходимость смотреть не только входящие и передача кириллицы в поиске. В конце показан связанный проект ycal для календаря и сценарий совместной работы почты и календаря.
Частые вопросы
Почему сервер не отправляет письма?
Автор решил это намеренно: письмо, ушедшее по ошибке модели, отозвать нельзя, а черновик, который человек проверяет и отправляет сам, стоит ровно ноль рисков.
Подходит ли обычный пароль от Яндекс ID?
Нет, нужен отдельный пароль приложения для IMAP-доступа к почте, обычный пароль аккаунта сервер не примет.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI