🏠 Главная › User Guide › email agentmail

{/ This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. /}

Agentmail

Give the agent its own dedicated email inbox via AgentMail. Send, receive, and manage email autonomously using agent-owned email addresses (e.g. hermes-agent@agentmail.to).

Skill metadata
Source Optional — install with hermes skills install official/email/agentmail
Path optional-skills/email/agentmail
Version 1.0.0
Tags email, communication, agentmail, mcp

Reference: full SKILL.md

ℹ️ Info

The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

AgentMail — Agent-Owned Email Inboxes

Requirements

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

2. Configure MCP Server

Add to ~/.hermes/config.yaml (paste your actual key — MCP env vars are not expanded from .env):

mcp_servers:
  agentmail:
    command: "npx"
    args: ["-y", "agentmail-mcp"]
    env:
      AGENTMAIL_API_KEY: "am_your_key_here"

3. Restart Hermes

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:
  2. Use create_inbox with a username (e.g. hermes-agent)
  3. The agent gets address: hermes-agent@agentmail.to
  4. Send an email:
  5. Use send_message with inbox_id, to, subject, text
  6. Check for replies:
  7. Use list_threads to see incoming conversations
  8. 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: user@example.com, subject: "Hello", text: "...")
3. list_threads to check for replies

Pitfalls

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