Skip to content

Give Hermes its own inbox.

Add Drin to ~/.hermes/config.yaml, sign in with Drin, and a Hermes cron job checks unread mail on a schedule.

Connect Hermes Agent in three steps.

Nous Research's open-source agent, with a gateway that runs its cron jobs.

  1. Add Drin

    Add this to ~/.hermes/config.yaml, then run hermes mcp login drin and sign in with Drin.

    config.yaml
    mcp_servers:
      drin:
        url: "https://mcp.drin.run/mcp"
        auth: oauth
  2. Sign in with Drin

    When the app opens Drin, sign in, choose which inbox it gets, and click Allow. No keys to paste.

  3. Check on a schedule

    In a Hermes chat, add a cron job that runs on a schedule you choose. The unread label keeps its place.

    /cron add "<your schedule>" "Check Drin for unread mail and handle it."

These steps follow Nous Research's own docs for Hermes Agent (hermes-agent.nousresearch.com). If Hermes Agent changes how it works, tell us and we'll fix this page.

It checks on a schedule.

Hermes can't be woken from outside, so a cron job checks for new mail on a schedule. The unread label is the cursor: handle a thread, mark it read, and the next check skips it.

MCP tools
# "On a schedule, check Drin for unread mail and handle it."
check_new_mail()                       # up to 20 unread threads, clean text
reply_email({ messageId, text })       # or create_draft for you to send
mark_read({ threadId })                # the unread label is the cursor

What Hermes Agent can and can't do.

What it can do

  • One block of config. Drin's hosted MCP with auth: oauth. hermes mcp login drin opens Drin to sign in.
  • A cron job. On each run it reads unread threads, handles them and marks them read.
  • Or hold the stream. Running a process that stays up? It can keep the event stream open and hear mail at once.

What it can't do

  • A cron job isn't woken by mail, so new mail waits for the next run.
  • A cron job runs inside the Hermes gateway. With no gateway up, the check is skipped.
  • It can't see inboxes you didn't pick. To its key, they answer 404 on reads and 403 on writes.
  • It can't mail a new address by itself. The first mail waits for a person, unless it's a reply to a verified sender in the same thread on an open desk.

Before you connect it.

Does it need a key in the config?
No. auth: oauth plus hermes mcp login drin signs in with Drin. You choose the inbox and what Hermes may do when you allow it.
How do I stop Hermes?
Pause its agent in Drin (Agents → Pause, or POST /v1/agents/:id/pause). Every key it holds answers 403 agent_paused until you resume it. Revoke is for good.
Do inboxes or apps cost extra?
No. There is no fee per inbox or per connected app.

The same inbox works in other apps.

Each app gets its own key. Pause one, and the others keep working.

Give Hermes Agent an address tonight.

Start free. Add your own domain whenever you like.