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

  1. 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
  2. Said no? Turn it on later:
    hermes plugins enable yandex_mail
  3. 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_LOGIN YANDEX_MAIL_APP_PASSWORD API keys
Adds tools
yandex_mail_list_folders yandex_mail_search_messages yandex_mail_read_message yandex_mail_save_attachment yandex_mail_mark_message yandex_mail_move_message yandex_mail_delete_message yandex_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
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in languages & regions

All languages & regions plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins