# Agent Mail — MCP server on mcp.ai
> Connect your Agent Mail account and use 5 tools for AI agents straight from your AI agent. Connect with your own API key. AgentMail provides AI agents with their own email inboxes, enabling them to send, receive, and act upon emails for communication with services, people, and other agents.

By: mcp.ai · official
Page: https://mcp.ai/agent_mail

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_agent_mail?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/agent_mail/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/agent_mail/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/agent_mail/skill.md
Postman collection (v2.1): https://mcp.ai/agent_mail/postman.json

## Tools
- agent_mail_create_inbox(domain?: string, username?: string, client_id?: string, display_name?: string) — Create a new AgentMail inbox via API. Returns the inbox_id and email address for sending/receiving messages. Use when provisioning new inboxes for agents or workflows.
- agent_mail_get_message(inbox_id: string, message_id: string) — Retrieve the complete details of a specific email message from an AgentMail inbox. This action returns the full message content including sender, recipients, subject, body (both text and HTML), attach
- agent_mail_list_inboxes(limit?: integer, ascending?: boolean, page_token?: string) — List all inboxes available to the authenticated AgentMail account. Use this to discover valid inbox_id values for message operations.
- agent_mail_list_messages(after?: string, limit?: integer, before?: string, labels?: string[], inbox_id: string, ascending?: boolean, page_token?: string, include_spam?: boolean) — List messages from an AgentMail inbox. Returns a `messages` array; each message uses `message_id` and `timestamp` fields (not `id`, `date`, or `items`).
- agent_mail_send_email(cc?: string[], to: string[], bcc?: string[], html?: string, text?: string, labels?: string[], subject: string, inbox_id: string, reply_to?: string[]) — Send an email using AgentMail API

## Example prompts
- "What can I do in Agent Mail?"
- "Show me a summary of my Agent Mail account"

## Links
Docs: https://mcp.ai/docs/mcps/agent_mail
Website: https://mcp.ai/mcps/agent_mail