Give your Hermes agent its own email address.

Install the OpenMail plugin, run setup, start the gateway. No IMAP or SMTP to configure, and no public URL needed.

Quick start

Three commands to a live inbox.

Install, paste a key, start the gateway. If anything is off, hermes openmail doctor says what.

Read the Docs
# Install the OpenMail plugin
hermes plugins install openmail --enable

# Paste a key from console.openmail.sh
hermes openmail setup

# Mail now wakes the agent
hermes gateway run
What's included

Everything the agent
needs to work by email.

Replies in the thread

Recipient and subject come from the thread. One conversation, not a new mail per answer.

No replies to machines

People get a reply. Automated mail becomes a notification. Spam never arrives.

Pods keep inboxes organised

Group inboxes, domains and API keys by team, customer or agent type.

Native tools and a bundled skill

Send, reply, read threads, extract attachments, or anything else you can do in the console.

Allow and block senders

Decide who can write to the agent or block all unwanted traffic.

Modes

Pick how your agent handles email.

Channel is the default. Change it by hand or ask your agent to do it for you.

Tool

On demand

Nothing arrives on its own. The agent sends and reads mail when you ask.

Notify

Summary to your home channel

New mail becomes a summary in your home channel: Telegram, Slack, or Discord. The sender never hears back.

Channel

Reply by email

Mail from a person wakes the agent; its answer is the reply. Automated mail arrives as a notification.

The plugin or Hermes's built-in email gateway?

Hermes ships with an email gateway that connects to a mailbox you already have, such as a Gmail account with an app password, over IMAP and SMTP. That's the right choice if you want the agent to work from an existing address. The OpenMail plugin is for when the agent should have an address of its own: the inbox is created through an API, mail is pushed to the agent as it arrives, replies are threaded for you, and you can give the agent a key that only opens its own inbox. You can run both.

Frequently asked questions.

Run hermes plugins install openmail --enable, then hermes openmail setup and paste an OpenMail API key, then hermes gateway run. Setup creates the inbox or picks an existing one, and asks who is allowed to email the agent. Look for "[OpenMail] Connected as <address>" in the gateway log. hermes openmail doctor checks the setup if anything is off.

Asks for an API key of any scope, picks an inbox or creates one, asks who may email the agent, and writes ~/.hermes/.env. hermes openmail doctor checks the result.

The addresses you list during setup, or whoever OpenMail's sender rules allow. Set allow and block rules per account, pod, or inbox in the console or with openmail policy on the CLI. Blocked mail is dropped before the agent sees it.

Yes. Point the plugin at a pod and it runs every inbox in it. The agent can create more inboxes and send from any of them.

Hermes already has a gateway. The plugin registers OpenMail as a platform, so mail wakes the agent over the gateway's websocket with no polling loop and nothing pasted into a prompt. The API key lives in the tools, not the model context.

Every Hermes agent deserves its own inbox.

Three commands, and your agent answers its own mail.

3 inboxes and 3,000 emails a month free · No credit card required