agentmail

Creates agent-owned email inboxes and sends or receives messages via the AgentMail MCP server.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill agentmail-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentmail
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/email/agentmail
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill agentmail-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agentmail-mcp, mcp.

What problem does it solve? Agents often need their own email identity to sign up for services, receive verification codes, or communicate with humans, but they cannot access a user's personal inbox. This Skill gives the agent a dedicated, programmable email address through AgentMail. ## Core Features & Use Cases - Agent-Owned Inboxes: Create and manage dedicated inboxes with real email addresses (e.g., [email protected]) via 11 MCP tools. - Full Email Operations: Send, reply, forward, list threads, read messages, and download attachments autonomously. - Use Case: Register the agent for an online service using its own inbox, poll for the verification email with list_threads, and read the confirmation code with get_thread — all without touching the user's personal email. ## Quick Start Create an AgentMail inbox called test-agent and send a welcome email to [email protected].

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 address?▼

Configure the agentmail-mcp server with an AgentMail API key, then call create_inbox with a username. The agent receives a real address like [email protected] and can send and receive email through 11 MCP tools.

How to send and receive email with AgentMail MCP tools?▼

Use send_message with inbox_id, to, subject, and text to send email. Poll list_threads to find incoming conversations and get_thread to read messages, then reply_to_message to respond.

Can AgentMail read my personal Gmail inbox?▼

No. AgentMail only manages inboxes the agent creates on the agentmail.to domain; it is not for reading a user's personal email. Use himalaya or Gmail integrations for personal inbox access.

What are the limitations of the AgentMail free tier?▼

The free tier allows 3 inboxes and 3,000 emails per month, and emails are sent from the @agentmail.to domain. Custom domains require a paid plan starting at $20 per month.

Why is the AgentMail MCP server not connecting?▼

The server requires Node.js 18+ and a valid API key pasted directly into the mcp_servers env config, since MCP env vars are not expanded from .env files. The mcp Python package must also be installed via pip.