Agent skill · marketing growth · nousresearch
agentmail
Use when an agent needs AgentMail CLI email inboxes.
Why this skill is useful
Adds specific API commands for managing email inboxes and sending/receiving messages that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires agentmail account access. About 2k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
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: Export an API key: No API key yet? Use signup.md. How to Run Use --format json whenever another command or script needs IDs. Quick Reference AgentMail agent reference: hosted copy. AgentMail: product landing page. Console: API keys and account management. Docs: full product documentation. signup.md: self-signup and OTP verification. core.md: inboxes, messages, threads, labels, attachments. webhooks.md: events to a public HTTPS server. websockets.md: events to a local agent process. mcp.md: MCP integration. Procedure 1. Install agentmail-cli@latest and verify agentmail inboxes list --format json. 2. If no API key is available, complete signup.md. 3. Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows. 4. Add webhooks.md or websockets.md only when polling is not enough. Pitfalls Prefer AGENTMAILAPIKEY over --api-key. Never expose AGENTMAILAPIKEY in prompts, logs, URLs, or committed files. Use stable clientid values for retried create operations. Prefer extractedtext or extractedhtml for LLM input when present. React to message.received, not messages the agent sent. Verification
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/agentmail