ClawAIMail API Docs

Email infrastructure for AI agents. Full REST API, MCP Server, and SDKs.

Quick Start

1. Register an account and get your API key:

curl -X POST https://api.clawaimail.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"secret123"}'

2. Create an inbox:

curl -X POST https://api.clawaimail.com/v1/inboxes \
  -H "Authorization: Bearer pb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"mybot"}'

# Returns: {"id":1,"address":"mybot@clawaimail.com",...}

3. Send an email:

curl -X POST https://api.clawaimail.com/v1/messages/send \
  -H "Authorization: Bearer pb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"inbox_id":1,"to":"user@gmail.com","subject":"Hello","text":"Hi from AI!"}'

Authentication

All API requests (except register/login/health) require a Bearer token:

Authorization: Bearer pb_your_api_key

Inboxes

Messages

Search

Threads

Labels

Webhooks

Custom Domains

API Keys

WebSocket (Real-time)

Connect to receive real-time email notifications:

const ws = new WebSocket('wss://api.clawaimail.com/v1/ws?key=pb_your_key');
ws.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log('New email:', data);
};

MCP Server

Use ClawAIMail directly from Claude, Cursor, or any MCP-compatible AI tool:

// Add to ~/.claude/mcp.json or Cursor MCP settings:
{
  "mcpServers": {
    "clawaimail": {
      "command": "npx",
      "args": ["clawaimail-mcp"],
      "env": {
        "CLAWAIMAIL_API_KEY": "pb_your_api_key"
      }
    }
  }
}

Available tools: list_inboxes, create_inbox, send_email, list_messages, read_email, search_emails, delete_inbox, account_info

SDKs

Node.js

npm install clawaimail

import ClawAIMail from 'clawaimail';

const mail = new ClawAIMail({ apiKey: 'pb_xxx' });
const inbox = await mail.createInbox({ username: 'mybot' });
await mail.sendMessage({
  inboxId: inbox.id,
  to: 'user@gmail.com',
  subject: 'Hello',
  text: 'Sent by AI!'
});
const messages = await mail.listMessages(inbox.id);

Python

pip install clawaimail

from clawaimail import ClawAIMail

mail = ClawAIMail(api_key="pb_xxx")
inbox = mail.create_inbox(username="mybot")
mail.send_message(
    inbox_id=inbox["id"],
    to="user@gmail.com",
    subject="Hello",
    text="Sent by AI!"
)
messages = mail.list_messages(inbox["id"])

Pricing

Plan	Inboxes	Emails/Day	Custom Domains	Price
Free	3	100	-	$0
Pro	50	5,000	Yes	$29/mo
Business	Unlimited	Unlimited	Yes	$99/mo

© 2026 ClawAIMail. Built for AI agents.