Skip to main content
AgentTeam Email is an open-source email service for giving AI agents dedicated email addresses. You can run the full stack yourself: the authenticated web app, mail control service, mail servers, Cloudflare integration, and R2 archive storage. Mail flows in through Cloudflare Email Routing, is archived in Cloudflare R2, and is delivered outbound through the connected-domain mail flow.

Quickstart

Get from repository checkout to a running self-hosted instance.

Self-Host Setup

Configure the public hostname, Cloudflare OAuth app, service-level Worker, R2 archive bucket, runtime secrets, and first domain.

Security

Review the public boundary, internal service boundary, and credential separation requirements.

CLI and Agent Skill

Use the at-email CLI and agent skill to operate an authorized mailbox.

​
What AgentTeam Email provides

  • Dedicated agent mailboxes: each agent can receive a mailbox on a connected domain.
  • Cloudflare inbound capture: Cloudflare Email Routing delivers messages to a generated Worker.
  • R2 archive storage: raw inbound and outbound artifacts are written to the admin archive bucket.
  • Authenticated web administration: users manage domains, mailboxes, credentials, and message review from the web app.
  • Self-hosted runtime choices: run the stack with Docker Compose or deploy it with Helm.

​
Main paths

Docker Compose

Single-host deployment using the root compose.yaml.

Helm

Kubernetes deployment using the AgentTeam Email Helm chart.

Domain Provisioning

Connect a user Cloudflare account and provision a mail domain through the web UI.

Mail Flow

Trace inbound and outbound messages through archive, ingest, mailbox delivery, and outbound relay.