How to Give Your Hermes Agent Its Own Email Inbox
Wire AgentMail to Hermes via MCP: typed tools at startup, per-subagent inboxes, CLI setup, config.yaml, and how it differs from OpenClaw’s SKILL.md pattern-without SMTP or OAuth.
- hermes
- hermes agent
- nous research
- agentmail
- mcp
- model context protocol
- agentmail mcp
- openclaw
- ai agents
- email agent
- programmatic inbox
- hermes email
- subagents
- agentmail hermes

Your Hermes agent needs email for the same reasons you do: outbound outreach, catching verification codes, handling inbound replies. The default options don't work. Gmail bans automated accounts. SendGrid is send-only. Building receive-and-reply infrastructure yourself is weeks of work. AgentMail is email built specifically for agents. Create an inbox in one API call. Send and receive immediately. No SMTP config, no OAuth. Because it connects to Hermes via MCP, every subagent Hermes spawns can provision its own isolated inbox for its task, automatically, in under a second.
How this is different from OpenClaw
OpenClaw adds email through a SKILL.md file. The agent reads it at runtime and the LLM interprets it to generate API calls. That works until it doesn't. Wrong parameter, malformed request, misread endpoint. It fails silently. The email doesn't send and you don't know why.
Hermes registers AgentMail as an MCP server. At startup, every tool is registered as a typed function with a defined schema: create_inbox, send_message, reply_to_message, list_threads. The agent calls the function directly. Bad parameter means an immediate explicit error. Wrong API key means you know on startup. Nothing fails silently.
| OpenClaw + SKILL.md | Hermes + MCP | |
|---|---|---|
| Tool registration | LLM interprets markdown at runtime | Typed schema registered at startup |
| Call execution | LLM generates API calls | Direct function call |
| Failure mode | Silent. Email doesn't send. | Explicit error immediately |
| Model sensitivity | Varies by model and version | Model-agnostic |
| Subagent support | Shared skill context | Every subagent owns its toolset |
What you need
- Hermes installed on your machine
- An AgentMail API key (free at console.agentmail.to, no card required)
- Node.js 18+
Step 1: Install Hermes
Bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashWorks on Mac, Linux, and WSL2. Takes about 3 minutes. When it finishes, the setup wizard runs automatically. Choose Quick setup, pick your model provider, and skip messaging platforms for now.
When done, reload your shell so PATH includes Hermes, or open a new terminal. Use the rc file your shell actually loads (not every install uses zsh):
Bash
source ~/.zshrc # zsh (default on macOS)Bash
source ~/.bashrc # bash (common on Linux and WSL2)If you use another shell (e.g. fish), run its equivalent reload or start a fresh session.
Step 2: Install the AgentMail CLI and confirm your key works
Bash
npm install -g agentmail-cliBash
export AGENTMAIL_API_KEY=YOUR_API_KEYBash
agentmail inboxes create --display-name "Test Agent"You should get back:
JSON
{ "inbox_id": "boldstory348@agentmail.to", "display_name": "Test Agent", "created_at": "2026-04-07T00:00:00Z"}If you see an inbox ID, your key works and you are ready for the next step.
Step 3: Add AgentMail to Hermes
Open the Hermes config:
Bash
nano ~/.hermes/config.yamlScroll to the bottom and add:
YAML
mcp_servers: agentmail: url: "https://mcp.agentmail.to/mcp" headers: x-api-key: "${AGENTMAIL_API_KEY}"Save with Control + O, Enter, Control + X.
Start Hermes:
Bash
hermesWhen Hermes loads, look for this line:
Code
43 tools · 76 skills · 1 MCP serversThat 1 MCP servers is AgentMail. All tools are registered and ready. If you update the config while Hermes is running:
Code
/reload-mcpNo restart needed.
Here is the full list of tools Hermes registers from AgentMail:
| Tool | What it does |
|---|---|
| create_inbox | Creates a new inbox with a unique email address |
| list_inboxes | Lists all inboxes |
| get_inbox | Gets details for a specific inbox |
| delete_inbox | Deletes an inbox |
| send_message | Sends an email from an inbox |
| reply_to_message | Replies to a message in a thread |
| list_threads | Lists threads in an inbox |
| get_thread | Gets a full thread with all its messages |
| get_attachment | Downloads an attachment from a message |
Step 4: Your agent's first email
In the Hermes chat:
Code
Create an inbox called outreach-agent and send an emailto hello@example.com with subject "First email from Hermes"and body "Sent via AgentMail MCP."Hermes calls create_inbox, gets the inbox ID, then calls send_message. Two typed function calls. The email lands.
To check for replies:
Code
Check the outreach-agent inbox for any new messagesand summarize what came in.Hermes calls list_threads, reads the results, and summarizes. Your agent is now a full email correspondent.
Step 5: Every subagent gets its own inbox
This is where Hermes and AgentMail become more than the sum of their parts.
Hermes delegates tasks to isolated subagents running in parallel. Each subagent gets its own conversation context, its own terminal, and its own access to the full AgentMail MCP toolset. That means each subagent can create its own inbox for its task, use it, and delete it when done. No shared inbox state. No message bleed between agents. If a bad email lands in one subagent's inbox, it is scoped to that task alone.
Tell Hermes:
Code
Spin up three parallel subagents. Each one should:1. Create its own AgentMail inbox2. Sign up for [service] using that inbox address3. Check the inbox for a verification email and extract the code4. Complete signup with the code5. Report the account details back6. Delete its inboxWhat happens:
Code
HERMES (parent)│├── SUBAGENT-1│ └── create_inbox → signs up → extracts OTP → reports → delete_inbox│├── SUBAGENT-2│ └── create_inbox → signs up → extracts OTP → reports → delete_inbox│└── SUBAGENT-3 └── create_inbox → signs up → extracts OTP → reports → delete_inboxThree parallel tasks. Three isolated inboxes. This pattern works for signup automation, parallel outbound threads, QA testing, and any workflow that benefits from isolated email identities at scale.
Scheduled email tasks
Hermes has a built-in natural language cron scheduler. Tell it what you want and it creates the schedule.
Code
Every weekday at 9am, check the support-agent inbox forunread messages, classify each one by urgency, draft repliesfor anything urgent, and send me a summary on Telegram.The task runs unattended through the Hermes gateway. No cron syntax, no config files.
Suggested Reading
New to agent email? Start here.
Why AI Agents Need Email The case for dedicated agent inboxes and why shared credentials break at scale.
AgentMail + Google ADK Same MCP pattern, different framework. If you are evaluating ADK alongside Hermes, read this next.
How To Give Your Browser Use Agent an Email Inbox Using AgentMail Browser automation and inbox provisioning in the same session. Signup flows, OTP handling, the full loop.
AgentMail + OpenClaw How the SKILL.md integration works if you are running both frameworks.




