Email for your Codex agent

AgentMail is the fastest way to give a Codex agent its own email inbox. It can send email, receive replies, and manage full conversation threads from a dedicated inbox it owns.

AgentMail ships an official plugin for Codex

Start for free Docs

[ Install ]

One command

The official AgentMail plugin for Codex installs in one command and gives your agent a dedicated inbox in under a minute.

Configure (credentials, email channel, verification)

[ Why email ]

Why your Codex agent needs its own inbox

One command, no key to paste

The plugin installs from github.com/agentmail-to/agentmail-plugins and points Codex at the hosted AgentMail MCP server, which you authorise with OAuth on first connect. The API key is only needed for the SDK and CLI paths.

Dedicated agent identity

Your Codex agent gets its own inbox with its own email address. It never sends from your personal email or shares your credentials.

Full programmatic control

Create inboxes, send messages, read replies, and manage threads - all through a clean SDK that works with any Python or Node.js environment.

Real-time notifications

Set up webhooks to get notified instantly when new emails arrive. Your agent can react immediately, not after a polling interval.

[ Code ]

Working code

[ FAQ ]

FAQ

Common questions about AgentMail and Codex.

Yes. The official AgentMail plugin for Codex is published from github.com/agentmail-to/agentmail-plugins. Add the marketplace with codex plugin marketplace add agentmail-to/agentmail-plugins, then install it with codex plugin add agentmail@agentmail. It bundles the AgentMail skills and points Codex at the hosted MCP server, which you authorise with OAuth on first connect rather than pasting an API key.

Yes. The AgentMail SDK works with any Python or Node.js environment, including Codex agents. Install the SDK, set your API key, and your agent can create inboxes, send emails, and manage threads.

Yes. Every AgentMail inbox is a real email address that can receive messages. Use webhooks or poll the API to get notified when new mail arrives.

The SDK supports sending and receiving attachments. Attach files when sending, and access attachment content when reading received messages.

Free tier: 3 inboxes. Developer plan ($20/mo): 10 inboxes. Startup plan ($200/mo): 150 inboxes. Enterprise capacity is tailored to the agreement.

Yes. The free tier includes 3 inboxes and up to 100 sends per day. No credit card required to start.

Gmail API requires OAuth and was built for human accounts, not programmatic agent use. SendGrid handles sending only - no receiving, no threading, no reply parsing. AgentMail gives your Codex agent a dedicated inbox it can create on demand, send from, receive on, and read - with full thread context and no credential sharing.