Чтобы подключить Яндекс Почту к himalaya, нужно включить IMAP и опцию «Пароли приложений и OAuth-токены», создать пароль приложения, подождать 2–3 часа до его активации и прописать серверы imap.yandex.ru и smtp.yandex.ru в конфиге. Пароль лучше хранить в отдельном файле с правами 600. После этого агент читает входящие и готовит письма из командной строки, без браузера.
Зачем агенту почта без браузера
20 ноября Яндекс 360 запустил MCP-сервер: через него внешние ИИ-агенты работают с Почтой, Диском, Календарём и другими сервисами. Сервер работает в режиме предварительного доступа. Агент получает права пользователя, а письма от его имени не отправляет: в документации шаблона MCP-сервера для Yandex AI Studio сказано, что отправка писем не поддерживается, а подготовленный черновик нужно проверить и отправить в Почте.
У такого подхода есть логика: он защищает от случайной отправки. Но для рабочих процессов получается лишний ручной шаг, и мы считаем это недоразумением. В himalaya, почтовом клиенте для командной строки, отправка письма занимает одну команду. Поэтому у нас агент полностью управляет ящиком: читает входящие, готовит и отправляет письма. Перед отправкой письмо просматривает человек и при необходимости правит.
Ниже инструкция, как подключить ящик. Она подойдёт и для Яндекс 360, и для обычной Яндекс Почты.
Что понадобится
- ящик на Яндекс 360 или обычная Яндекс Почта;
- himalaya 2.2.1;
- 10 минут на настройку и 2–3 часа ожидания, пока Яндекс активирует пароль приложения.
В README проекта himalaya версия 2 помечена как ещё не выпущенная, а мы работаем с 2.2.1. Поэтому образец конфига берите из репозитория для того релиза, который установили: схема настроек между v1 и v2 различается.
Шаг 1. Настройте ящик
Откройте в настройках Яндекс Почты раздел «Почтовые программы». Включите доступ с сервера imap.yandex.ru по протоколу IMAP и проверьте, что включена опция «Пароли приложений и OAuth-токены». Если вторая опция выключена, пароль приложения Яндекс не примет. Сохраните изменения.
Для ящика организации сначала нужно включить почтовые протоколы в консоли администратора: «Почта» → «Настройки». Если организация новая, каждому сотруднику стоит один раз войти в веб-Почту и принять условия сервисов: Яндекс описывает, что без этого вход из почтовой программы может не пройти.
Шаг 2. Создайте пароль приложения
В Яндекс ID откройте «Безопасность» → «Пароли приложений», выберите тип «Почта» и придумайте название, например «himalaya». Яндекс покажет пароль один раз. Скопируйте его сразу: если окно закрыть, придётся удалить пароль и создать новый.
Пароль начинает действовать через 2–3 часа. Если вход не проходит сразу после создания, проблема, скорее всего, в этом, а не в конфиге.
Основной пароль от аккаунта в клиент не вводим. Пароль приложения даёт доступ только к тому, для чего создан, и отзывается отдельно: если его скомпрометируют, аккаунт остаётся под вашим контролем. Яндекс также рекомендует OAuth, если клиент его поддерживает.
Шаг 3. Положите пароль в отдельный файл
Пароль не должен лежать в конфиге открытым текстом. Сохраним его в файле, который читает только владелец:
echo "MAIL_PASSWORD='ваш-пароль-приложения'" > ~/.config/mail.env
chmod 600 ~/.config/mail.env
Шаг 4. Допишите аккаунт в конфиг
Добавьте аккаунт в ~/.config/himalaya/config.toml. Для Яндекс 360 логином служит полный адрес ящика:
[accounts.work]
email = "you@company.ru"
display-name = "Ваше имя"
message.send.save-copy = "sent"
mailbox.alias.inbox = "Inbox"
mailbox.alias.sent = "Sent"
mailbox.alias.drafts = "Drafts"
mailbox.alias.trash = "Trash"
mailbox.alias.junk = "Spam"
imap.server = "imaps://imap.yandex.ru:993"
imap.sasl.plain.username = "you@company.ru"
imap.sasl.plain.password.command = ["sh", "-c", ". ~/.config/mail.env; printf %s \"$MAIL_PASSWORD\""]
smtp.server = "smtps://smtp.yandex.ru:465"
smtp.sasl.plain.username = "you@company.ru"
smtp.sasl.plain.password.command = ["sh", "-c", ". ~/.config/mail.env; printf %s \"$MAIL_PASSWORD\""]
Серверы и порты совпадают со справкой Яндекса: IMAP imap.yandex.ru на порту 993 с SSL, SMTP smtp.yandex.ru на порту 465 с SSL.
Шаг 5. Проверьте подключение
himalaya envelope list -a work -s 10
himalaya message read -a work 123
Первая команда показывает десять последних писем, вторая читает письмо по номеру. Для первой отправки напишите тестовое письмо самому себе.
Три места, где мы споткнулись
С версии 2 схема конфига другая. Теперь это imap.server, smtp.server и sasl.plain.*. Со старым backend.type конфиг загрузится без ошибки, но аккаунт окажется без бэкендов. В списке аккаунтов у такого аккаунта колонка бэкендов остаётся пустой.
Яндекс сам не сохраняет отправленное. Без строки message.send.save-copy = "sent" письмо уйдёт, но в папке «Отправленные» не появится.
Папка спама называется Spam. Поэтому алиас junk указывает на неё.
Лимиты отправки
Для писем, отправленных через почтовую программу или по SMTP, Яндекс устанавливает лимит 300 писем в сутки. Одно письмо с десятью получателями считается за десять, а копии и скрытые копии учитываются тоже. Лимит может сработать раньше, если система защиты заподозрит массовую рассылку шаблонных писем. Яндекс прямо пишет, что личные ящики не предназначены для массовых рассылок и рабочих переписок, и предлагает для рассылок Яндекс 360 для бизнеса и Яндекс Рассылки.
Для писем «один на один» этого достаточно. Для рассылок нужен отдельный сервис.
Черновики и вложения
Если агент сохраняет черновики через himalaya, учтите два момента.
- Собирайте письмо с переводами строк CRLF и частью text/html. Черновик только с text/plain веб-клиенты могут показать пустым.
- Имена вложений с кириллицей кодируйте по RFC 2047. RFC 2231 у нас не сработал: получатель видел вложение как noname.eml.
Какой доступ мы даём агенту
У нас агент полностью управляет почтой: читает входящие, готовит и отправляет письма. Я просматриваю письмо перед отправкой и при необходимости правлю. Контроль задаёт наш процесс, а не ограничение клиента: himalaya позволяет отправлять письма, поэтому границу вы определяете сами.
Если вы только начинаете, заведите отдельный ящик для агента и просматривайте его письма перед отправкой, пока не убедитесь в качестве. Отдельный ящик для переписки с агентом и отдельный для рассылок дают понятные права и берегут репутацию домена. О том, где запускать такого агента, мы писали в статьях про Claude Code на VPS и локального ИИ-агента, а как открывать на любом устройстве то, что агент присылает на проверку, показывает статья про Tailscale вместо localhost.
Частые вопросы
Почему вход не проходит сразу после создания пароля приложения?
Яндекс указывает, что пароль начинает действовать через 2–3 часа после создания. Проверьте также, что включена опция «Пароли приложений и OAuth-токены».
Можно ли использовать основной пароль от аккаунта?
Нет. Для сторонних программ нужен пароль приложения. Он ограничен конкретным типом доступа и отзывается отдельно.
Чем himalaya отличается от MCP-сервера Яндекс 360?
MCP-сервер запущен на стороне Яндекса, находится в предварительном доступе и по документации не отправляет письма от имени пользователя. himalaya работает с ящиком по IMAP и SMTP, поэтому набор действий определяете вы.
Сколько писем можно отправить в сутки?
Через почтовую программу или SMTP Яндекс разрешает 300 писем в сутки, с учётом каждого получателя. Для рассылок используйте специальный сервис.
Что дальше
Когда почта подключена, на её основе можно собирать агентов: разбор входящих заявок, подготовка ответов, напоминания по переписке. Если вы хотите понять, какие почтовые и документные процессы в вашей компании стоит передать агенту, напишите нам: разберём процесс и подскажем, с чего начать.
Источники: справка Яндекса по настройке почтовых программ, пароли приложений Яндекс ID, ограничения на отправку писем, новость о запуске MCP-сервера Яндекс 360, шаблоны MCP-серверов Yandex AI Studio.




