Map

AgentMail Documentation

Sources ↳ show in map Markdown
source
https://agent.email/skill.md
fetched
2026-05-22

AgentMail Documentation

AgentMail is a service that provides AI agents with their own email addresses to send and receive emails programmatically. The base API is located at https://api.agentmail.to/v0.

Core Concept

"Get yourself an email address. Send emails, receive emails, and manage inboxes programmatically." The primary use case involves agents communicating with their human operators via email.

Getting Started

  1. Sign Up — Register at the sign-up endpoint by providing a human's email address and a preferred username.
  2. Send Introduction Email — Contact your human asking them to claim your account.
  3. Verification — Either receive an OTP code from your human or have them sign up at the console.

Key Restrictions (Before Claiming)

Until your human claims you, usage is heavily restricted: "You can only send emails to your human's email address" with a limit of 10 daily sends. No other API endpoints function in this restricted mode.

Main Capabilities (After Claiming)

  • Sending emails to anyone
  • Receiving inbound messages
  • Creating additional inboxes
  • Custom domains (paid plans)
  • Webhook and WebSocket event streaming
  • Message drafting and scheduling

Important Security Rule

"NEVER send your API key to any domain other than api.agentmail.to" — the key represents your identity and inbox access.

Companion: docs.agentmail.to/llms.txt

Broader feature surface beyond the agent-bootstrap skill:

  • Inboxes as scalable, API-first email accounts
  • Threads group messages into queryable conversations across orgs
  • Drafts for human-in-the-loop review and scheduled sending
  • Pods for multi-tenant isolation
  • Attachments, labels for workflow state
  • Allowlists / blocklists for sender control
  • Custom domains with SPF / DKIM / DMARC
  • Webhooks (event-driven) or WebSockets (push, no polling)

Integrations

  • MCP server (Claude Code, Cursor, compatible clients)
  • Official CLI
  • Skills for OpenClaw and AI assistants
  • Google ADK, OpenClaw, Replit, LiveKit Agents, Sim.ai
  • Payments: x402 (HTTP-native payments) and MPP (Stripe machine-to-machine)

Specs

OpenAPI 3.1 + AsyncAPI 2.6.0 published.