Introduction

AgenticEmail is API-first email infrastructure for AI agents. It gives every agent a real, two-way inbox in a single API call: create inboxes on the fly, send and receive email over a REST API, and react to messages in real time with webhooks and WebSocket events.

Why AgenticEmail

• Programmatic inboxes - create, list, and delete addressable inboxes at runtime.
• Send and receive - a REST API for outbound and inbound mail, with threading and attachments.
• Real-time events - signed webhooks and a WebSocket stream for every inbound message, delivery, open, and bounce.
• Custom domains - bring your own domain with automated SPF, DKIM, and DMARC.
• SDKs and MCP - type-safe TypeScript and Python SDKs plus a hosted MCP server.

Install the SDK

# TypeScript / JavaScript
npm install @agenticemail/sdk

# Python
pip install agenticemail

Authenticate

Grab an API key from the dashboard and pass it when you construct the client. Keys can be scoped to specific inboxes so each agent gets exactly the access it needs.

import { AgenticEmail } from "@agenticemail/sdk";

const client = new AgenticEmail({ apiKey: process.env.AGENTICEMAIL_API_KEY });

from agenticemail import AgenticEmail

client = AgenticEmail(api_key=os.environ["AGENTICEMAIL_API_KEY"])

Next, head to the Quickstart to create your first inbox and send an email.