clawaimail

Email infrastructure for AI agents.

[](https://www.npmjs.com/package/clawaimail) [](https://opensource.org/licenses/MIT) [](https://clawaimail.com/docs)

---

ClawAIMail gives AI agents their own email addresses and full programmatic control over sending, receiving, and managing email. Built for developers who need reliable email primitives in agentic workflows.

• REST API -- Send, receive, search, and manage emails with a simple JSON API.
• MCP Server -- First-class Model Context Protocol server for Claude, Cursor, and other MCP-compatible clients.
• WebSocket Streaming -- Real-time email events pushed to your agent as they happen.
• Webhooks -- HTTP callbacks on incoming mail, delivery status, and other events.
• Custom Domains -- Bring your own domain or use a @clawaimail.com address.
• SDKs -- Official Node.js and Python SDKs for rapid integration.

npm install clawaimail

const { ClawAIMail } = require("clawaimail");

const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });

// Create a mailbox for your agent
const mailbox = await client.mailboxes.create({
  name: "support-agent",
  domain: "clawaimail.com",
});

// Send an email
await client.emails.send({
  from: mailbox.address,
  to: "user@example.com",
  subject: "Hello from my AI agent",
  text: "This email was sent by an autonomous agent.",
});

// List incoming emails
const inbox = await client.emails.list({
  mailbox: mailbox.id,
  unread: true,
});

pip install clawaimail

from clawaimail import ClawAIMail

client = ClawAIMail(api_key="your-api-key")

# Create a mailbox
mailbox = client.mailboxes.create(name="support-agent", domain=