agentmail

Manage agent-owned email inboxes for sending, receiving, and handling attachments.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill agentmail-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentmail
Source: https://github.com/MarbleSodas/Mavis/tree/main/optional-skills/email/agentmail
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill agentmail-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agentmail solves the problem of letting an AI agent communicate, authenticate, and coordinate using its own dedicated email identity without relying on a personal mailbox.

Core Features & Use Cases

  • Dedicated agent inboxes: Create and manage agent-owned email addresses.
  • Autonomous message handling: Send, reply, forward, and update message labels/status.
  • Thread-based reading and attachments: List threads, fetch thread contents, and download attachments for review or follow-up.

Use Case: Set up an inbox for an outreach agent to register on services, monitor verification emails, and respond when replies arrive—while keeping the agent’s identity separate from the user.

Quick Start

Configure the AgentMail MCP server in ~/.hermes/config.yaml with your AGENTMAIL_API_KEY, restart Hermes, and ask Hermes to create an AgentMail inbox for your agent and return the inbox email address.

Frequently Asked Questions about agentmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I give an AI agent its own email inbox for autonomous workflows?

An AI agent can use a dedicated email inbox to send, receive, and manage messages autonomously by configuring the AgentMail MCP server with an API key, enabling the agent to handle service signups and verification codes without relying on a personal mailbox.

How do I configure an MCP server for agent email management?

To configure the MCP server for agent email management, add your AGENTMAIL_API_KEY to the Hermes config file at ~/.hermes/config.yaml, restart Hermes with MCP toolsets enabled, and ask Hermes to generate a new inbox address for your agent.

Can an AI agent read email threads and download attachments autonomously?

Yes, an AI agent can list email threads, fetch thread contents, and download attachments autonomously through the AgentMail MCP server, allowing it to review conversations and handle files for follow-up actions.

What's the best way to separate an AI agent's email identity from my personal mailbox?

The best way to separate an AI agent's email identity is to create a dedicated agent-owned inbox, which allows the agent to perform outreach, register on services, and authenticate independently without mixing with your personal messages.

Does agent email management work for retrieving verification codes during service signups?

Yes, agent email management works for retrieving verification codes during service signups by providing a dedicated address where the agent can monitor incoming verification emails and extract the needed codes autonomously.

What are the limitations of using a dedicated agent inbox for autonomous communication?

A limitation of using a dedicated agent inbox is that it requires a configured AgentMail MCP server with an active AGENTMAIL_API_KEY and Hermes running with MCP toolsets enabled, meaning it cannot function without this specific environment setup.