agentmail

# AgentMail Skill AgentMail gives an agent its own email inbox for sending mail, receiving replies, completing email OTP flows, and running inbound email loops. Use it for agent-owned inboxes, not a user's existing IMAP/SMTP mailbox. Use the `agentmail` CLI first. Use MCP only when the harness expects MCP tools; use REST only when the CLI is missing a required operation. ## When to Use - The agent needs an email address it owns. - The task involves email OTP flows, replies, threads, labels, or attachments. - The agent needs webhook or WebSocket delivery for inbound mail. ## Prerequisites - Run commands through the `terminal` tool. - Install the CLI: ```bash npm install -g agentmail-cli@latest ``` - Export an API key: ```bash export AGENTMAIL_API_KEY="am_..." ``` No API key yet? Use [signup.md](references/signup.md). ## How to Run Use `--format json` whenever another command or script needs IDs. ```bash agentmail inboxes list --format json ``` ## Quick Reference - [AgentMail agent reference](https://agentmail.md): hosted copy. - [AgentMail](https://agentmail.to): product landing page. - [Console](https://console.agentmail.to): API keys and account management. - [Docs](https://docs.agentmail.to): full product documentation. - [signup.md](references/signup.md): self-signup and OTP verification. - [core.md](references/core.md): inboxes, messages, threads, labels, attachments. - [webhooks.md](references/webhooks.md): events to a public HTTPS server. - [websockets.md...