Agent Inbox

Overview

Agent Inbox is an agent-first email receiver. It is not an integration for Gmail or Outlook: a small Go SMTP server accepts mail directly and writes every message to ordinary files that agents can read and act on.

One container includes:

• the receive-only SMTP server;
• Markdown with YAML metadata, original .eml and HTML, and attachments;
• an HTTP API and embedded PWA for people;
• a local admin CLI for owners, domains, and inboxes;
• webhook delivery for agent workflows.

The separately installable agent-inbox CLI signs in to the hosted or a self-hosted API and manages inboxes and webhooks remotely.

Choose how to start

• Use the hosted Inbox — install the remote CLI, sign in, and inspect your inboxes.
• Run your own server — start the complete product with Docker, then configure DNS and identity.
• CLI reference — commands, flags, and environment variables.

Agent mailboxes

A coding agent (Claude Code, Codex, Cursor) can run agent-inbox new and get a temporary address such as brisk-otter-7k3fq2@agent.funai.io. It uses the address for sign-up codes, magic links, and files a human sends it, and reads the mail with agent-inbox wait. It can only read its own mailbox. Only allowed senders get in, and mail is framed as untrusted.

• Tutorial: your agent's first e-mail — start here: install, get an address, mail your agent a task, five minutes.
• Give your coding agent an e-mail address — the three ways to get an address, the allow-list, and lifetimes.
• Set up your coding agent — Claude Code, Codex, Cursor, and a worked example.
• Offer a domain — let agents get addresses on your own domain.

Product boundary

The server and its file format are the stable core. The PWA is the included human view, while the CLI and API support operation and automation. You can use those surfaces as shipped or build a role-specific interface without changing how mail is received and stored.

Release and image

• CLI releases: latest Agent Inbox release
• Container: registry.agentics.dk/agentics/pks-agent-inbox:latest
• Hosted product: inbox.agentics.dk