# NousResearch/hermes-agent · AgentMail integration for agent-owned email inboxes

## Open now

- Nothing open on GitHub.

These items all relate to adding AgentMail support, enabling agents to own and operate email inboxes. The work spans a feature request, a native tool implementation, and a skill addition.

## TL;DR

- 3 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 1 PR(s) closed without merging.
- A fix was merged to main in PR #330. Verify it addresses your case.
- **Recommended:** read PR #330 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-330`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.67`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #329: Feature: AgentMail Integration — Agent-Owned Email Inboxes

## Prior & competing PRs

- **#330: feat: add AgentMail skill for agent-owned email inboxes**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `skills/email/agentmail/SKILL.md`
  - fix hunks:
  - `skills/email/agentmail/SKILL.md`

    ```diff
    @@ -0,0 +1,131 @@
    +---
    +name: agentmail
    +description: Give the agent its own dedicated email inbox via AgentMail. Send, receive, and manage email autonomously using agent-owned email addresses (e.g. [redacted:email]).
    +version: 1.0.0
    +metadata:
    +  hermes:
    +    tags: [email, communication, agentmail, mcp]
    +    category: email
    +---
    +
    +# AgentMail — Agent-Owned Email Inboxes
    +
    +## When to Use
    +Use this skill when you need to:
    +- Give the agent its own dedicated email address
    +- Send emails autonomously on behalf of the agent
    +- Receive and read incoming emails
    +- Manage email threads and conversations
    +- Sign up for services or authenticate via email
    +- Communicate with other agents or humans via email
    +
    +This is NOT for reading the user's personal email (use himalaya or Gmail for that).
    +AgentMail gives the agent its own identity and inbox.
    +
    +## Setup
    +
    +### 1. Get an API Key
    +- Go to https://console.agentmail.to
    +- Create an account (free tier: 3 inboxes, 3,000 emails/month)
    +- Generate an API key (starts with `am_`)
    +
    +### 2. Configure Hermes
    +Add to `~/.hermes/.env`:
    +```
    +AGENTMAIL_API_KEY=[redacted:secret-assignment]
    +```
    +
    +Add to `~/.hermes/config.yaml`:
    +```yaml
    +mcp_servers:
    +  agentmail:
    +    command: "npx"
    +    args: ["-y", "agentmail-mcp"]
    +    env:
    +      AGENTMAIL_API_KEY: "[redacted:secret-assignment]"
    +```
    +
    +### 3. Verify Node.js is installed
    +```bash
    +node --version  # Should be 18+
    +```
    +
    +### 4. Restart Hermes
    +```bash
    +hermes
    +```
    +All 11 AgentMail tools are now available automatically.
    +
    +## Available Tools (via MCP)
    +
    +| Tool | Description |
    +|------|-------------|
    +| `list_inboxes` | List all agent inboxes |
    +| `get_inbox` | Get details of a specific inbox |
    +| `create_inbox` | Create a new inbox (gets a real email address) |
    +| `delete_inbox` | Delete an inbox |
    +| `list_threads` | List email threads in an inbox |
    +| `get_thread` | Get a specific email thread |
    +| `send_message` | Send a new email |
    +| `reply_to_message` | Reply to an existing email |
    +| `forward_message` | Forward an email |
    +| `update_message` | Update message labels/status |
    +| `get_attachment` | Download an email attachment |
    +
    +## Procedure
    +
    +### Create an inbox and send an email
    +1. Create a dedicated inbox:
    +   - Use `create_inbox` with a username (e.g. `hermes-agent`)
    +   - The agent gets address: `[redacted:email]`
    +2. Send an email:
    +   - Use `send_message` with `inbox_id`, `to`, `subject`, `text`
    +3. Check for replies:
    +   - Use `list_threads` to see incoming conversations
    +   - Use `get_thread` to read a specific thread
    +
    +### Check incoming email
    +1. Use `list_inboxes` to find your inbox ID
    +2. Use `list_threads` with the inbox ID to see conversations
    +3. Use `get_thread` to read a thread and its messages
    +
    +### Reply to an email
    +1. Get the thread with `get_thread`
    +2. Use `reply_to_message` with the message ID and your reply text
    +
    +## Example Workflows
    +
    +**Sign up for a service:**
    +```
    +1. create_inbox (username: "signup-bot")
    +2. Use the inbox address to register on the service
    +3. list_threads to check for verification email
    +4. get_thread to read the verification code
    +```
    +
    +**Agent-to-human outreach:**
    +```
    +1. create_inbox (username: "hermes-outreach")
    +2. send_message (to: [redacted:email], subject: "Hello", text: "...")
    +3. list_threads to check for replies
    +```
    +
    +## Pitfalls
    +- Free tier limited to 3 inboxes and 3,000 emails/month
    +- Emails come from `@agentmail.to` domain on free tier (custom domains on paid plans)
    +- Node.js (18+) is required for the MCP server (`npx -y agentmail-mcp`)
    +- The `mcp` Python package must be installed: `pip install mcp`
    +- Real-time inbound email (webhooks) requires a public server — use `list_threads` polling via cronjob instead for personal use
    +
    +## Verification
    +After setup, test with:
    +```
    +hermes --toolsets mcp -q "Create an AgentMail inbox called test-agent and tell me its email address"
    +```
    +You should see the new inbox address returned.
    +
    +## References
    +- AgentMail docs: https://docs.agentmail.to/
    +- AgentMail console: https://console.agentmail.to
    +- AgentMail MCP repo: https://github.com/agentmail-to/agentmail-mcp
    +- Pricing: https://www.agentmail.to/pricing
    ```
- **#398: feat(agentmail): native AgentMail tool for agent-owned email inboxes**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#330`, `#329`

## Fix status

- Merged to main in PR #330 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-03-09`. This confirmation is old and may be out of date (a revert/reopen would not have invalidated it here); re-verify.
- Subsystem: `optional-skills/email`