Yandex Mail

From its catalog listing
Search and read Yandex Mail, organize messages and reply through IMAP/SMTP. Choose which folders and actions Hermes can use; saving attachments and sending require explicit opt-in.
Good to know before installing
reads and changes your Yandex Mail over IMAP at imap.yandex.ru and sends over SMTP at smtp.yandex.ru (or the hosts in YANDEX_MAIL_IMAP_HOST / YANDEX_MAIL_SMTP_HOST if you set them, which are not restricted to Yandex), over verified TLS, with your YANDEX_MAIL_LOGIN and YANDEX_MAIL_APP_PASSWORD read through Hermes; flagging, moving and deleting, including irreversible permanent deletion, are offered unless YANDEX_MAIL_ACTIONS narrows them (read gives a read-only mailbox); saving attachments and sending are off until YANDEX_MAIL_ACTIONS names save_attachment and send_message; once on, sending asks no per-message confirmation, also in cron and other unattended runs, and reaches any address unless YANDEX_MAIL_SEND_TO fences recipients; saved attachments go to Hermes' shared document cache, where other tools can read them, and are pruned after 24 hours; mail written by other people reaches the agent as tool output; uses Hermes' private tools.credential_files helper to map saved paths into sandboxes; no other endpoint, no telemetry, no shell access, no background process. Independent community plugin, not affiliated with Yandex.
From its catalog listing.
How to install
- Install it. Hermes asks for any API keys it needs (this one needs
YANDEX_MAIL_LOGIN,YANDEX_MAIL_APP_PASSWORD), then asks whether to turn it on.hermes plugins install yandex_mail - Said no? Turn it on later:
hermes plugins enable yandex_mail - Restart Hermes so it loads the plugin.
Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).
- Category
- Languages & regions · Web, research & browsing
- Maintained by
- akinfold (Community)
- Needs
YANDEX_MAIL_LOGINYANDEX_MAIL_APP_PASSWORDAPI keys- Adds tools
yandex_mail_list_foldersyandex_mail_search_messagesyandex_mail_read_messageyandex_mail_save_attachmentyandex_mail_mark_messageyandex_mail_move_messageyandex_mail_delete_messageyandex_mail_send_message- Works on
- linux, macos
- Needs Hermes
- 0.21.5 or newer
- Version
- 0.4.4
- In the catalog
- 2026-11-07, updated 2026-11-09
Known issues (from its catalog listing)
- Default tools include flagging, moving and deletion, including irreversible permanent deletion. Set YANDEX_MAIL_ACTIONS=read for read-only access, then restart Hermes. Saving attachments and sending require explicit save_attachment and send_message opt-ins.
- Sending has no per-message confirmation, including unattended runs. YANDEX_MAIL_SEND_TO limits recipients; an explicit empty value refuses all recipients, while an absent value imposes no recipient restriction.
- The login and app password go to imap.yandex.ru and smtp.yandex.ru over verified TLS, or to configured IMAP/SMTP hosts. Host overrides are not restricted to Yandex-owned servers. Message bodies, headers and filenames are untrusted tool output.
- Saving writes to the current profile's shared temporary document cache, outside HERMES_WRITE_SAFE_ROOT; other Hermes tools can read it and cache cleanup can remove it. Saving needs POSIX directory operations and hard links.
- Remote attachment paths use Hermes' private tools.credential_files.to_agent_visible_cache_path helper because no public replacement exists. A helper error fails saving and removes the file; a mapping miss may return a host path that remote tools cannot access. Multiplexed gateway reloads without an active secret scope can fail closed.
Using the Hermes desktop app? See where plugins live

Full setup & settings ↗Source code ↗
More in languages & regions
All languages & regions plugins
New Hermes Agent updates every day on X. Follow @HermesWatcher