Clawaimail

ClawAIMail

Email infrastructure for AI agents.

[npm version] [License: MIT] [Documentation]

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.

Features

• 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.

Quick Start

Node.js

npm install clawaimail

const { ClawAIMail } = require("clawaimail");
const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });
// Create a mailbox for your agentconst mailbox = await client.mailboxes.create({  name: "support-agent",  domain: "clawaimail.com",});
// Send an emailawait client.emails.send({  from: mailbox.address,  to: "[email protected]",  subject: "Hello from my AI agent",  text: "This email was sent by an autonomous agent.",});
// List incoming emailsconst inbox = await client.emails.list({  mailbox: mailbox.id,  unread: true,});

Python

pip install clawaimail

from clawaimail import ClawAIMail
client = ClawAIMail(api_key="your-api-key")
# Create a mailboxmailbox = client.mailboxes.create(name="support-agent", domain="clawaimail.com")
# Send an emailclient.emails.send(    from_address=mailbox.address,    to="[email protected]",    subject="Hello from my AI agent",    text="This email was sent by an autonomous agent.",)
# List incoming emailsinbox = client.emails.list(mailbox=mailbox.id, unread=True)

MCP Server

ClawAIMail ships an MCP server so that Claude, Cursor, and other MCP-compatible clients can use email tools directly.

Claude Desktop

Add the following to your Claude Desktop MCP config (claude_desktop_config.json):

{  "mcpServers": {    "clawaimail": {      "command": "npx",      "args": ["-y", "clawaimail-mcp"],      "env": {        "CLAWAIMAIL_API_KEY": "your-api-key"      }    }  }}

Cursor

Add to your .cursor/mcp.json:

{  "mcpServers": {    "clawaimail": {      "command": "npx",      "args": ["-y", "clawaimail-mcp"],      "env": {        "CLAWAIMAIL_API_KEY": "your-api-key"      }    }  }}

Once configured, the agent can call tools like send_email, read_inbox, search_emails, and create_mailbox without any additional code.

Self-Hosting

ClawAIMail can be self-hosted for full control over your email infrastructure.

# Clone the repositorygit clone https://github.com/joansongjr/clawaimail.gitcd clawaimail
# Install dependenciesnpm install
# Configure environmentcp .env.example .env# Edit .env with your SMTP credentials, database URL, and API keys
# Run database migrationsnpm run db:migrate
# Start the servernpm start

The server will be available at http://localhost:3000 by default. See the self-hosting docs for production deployment guides (Docker, Railway, Fly.io).

API Endpoints

Full API reference: clawaimail.com/docs/api

Pricing

Self-hosted deployments are free and unlimited. See clawaimail.com/pricing for details.

Links

• Documentation
• Node.js SDK
• Python SDK
• Website
• Status Page

License

MIT -- see LICENSE for details.