Works where you work.

Designed for agents from the ground up.

Email APIs were built to blast. OpenMail is built for the reply.

Message received

200 OK
from: user@company.com
subject: Re: Project Alpha
via: Webhook · WebSocket

Usage modes

Pick how your agent handles email.

Built into the OpenClaw and Hermes plugins. Set it with --mode on OpenClaw or OPENMAIL_MODE on Hermes, and switch anytime.

Quick Start

Works with the agents you already use.

One command gives OpenClaw, Hermes or Claude Code an inbox. Or hit the REST API directly and take replies over WebSocket.

1. OpenClaw
2. Hermes
3. Claude Code
4. CLI
5. TypeScript
6. Python
7. LangChain
8. AI SDK

# Install the OpenMail channel plugin
openclaw plugins install clawhub:@openmail/openclaw

# Add the channel with a key from console.openmail.sh
# → picks or creates your inbox, stores an inbox-scoped key
openclaw channels add --channel openmail --api-key om_xxx --mailbox-name support
openclaw gateway restart

# Mail from people wakes the agent; it replies in-thread.
# --mode notify: agent tells you about new mail instead
# --mode tool:   agent uses email only when asked

# The OpenMail CLI runs inside the gateway
openclaw openmail -- threads list --is-read false --json

Use cases

Signup automation

Browser agents that can actually sign up.

OTP codes and verification links land in the agent's inbox. It finishes signup itself.

AI support inbox

Support that replies itself.

Your agent triages and answers support mail in-thread. No ticketing API, nothing new to learn.

Doc processing

Receipts in. Structured data out.

Forward invoices to an agent inbox and get JSON back.

Frequently asked questions.

01 How do I get started?

For OpenClaw, install the @openmail/openclaw plugin and run openclaw channels add --channel openmail --api-key <key>. For Hermes, run hermes plugins install openmail --enable then hermes openmail setup. For other agents, install the CLI with npm install -g @openmail/cli and run openmail init to create your first inbox. See the quickstart for details.

02 Who is OpenMail for?

Developers building AI agents, and the agents themselves. If your agent needs an email address, OpenMail is the email layer.

03 Can an agent have multiple inboxes?

Yes. See Inboxes in the docs.

04 Can I create many inboxes?

Yes. One account, many inboxes. Each inbox has a unique ID that appears in every event so you can route to the right agent.

05 How do I receive inbound email?

Webhook or WebSocket. The OpenClaw plugin keeps a WebSocket open inside the gateway, so inbound mail wakes the agent with no public URL. From your own code, open a WebSocket or set a webhook URL in the Dashboard. Webhooks and WebSockets guides have the full setup.

06 What about attachments?

Inbound attachments come as download URLs in the payload. Fetch them with your API key. PDFs, CSVs, and images can be parsed to LLM-ready text at additional cost or with your provider key. Attachments in the docs.

07 How does pricing work?

Free forever: 3 inboxes, 3,000 emails/month, no credit card required. Pro plan is €9/month for 10 inboxes and 10,000 emails included, then usage-based pricing beyond that. Enterprise offers custom volume. No commitment, cancel anytime. See pricing.

08 How do I give an AI agent its own email address?

Install the OpenMail CLI with npm install -g @openmail/cli, run openmail init, and your agent has an inbox in under a minute. Or call POST /v1/inboxes and get a live address back.