llms.txt Content
# ClawAIMail
> Email infrastructure for AI agents. Give your AI a real email address with full send/receive capabilities.
## What is ClawAIMail?
ClawAIMail is an API-first email service designed for AI agents. It provides:
- Instant email inboxes (e.g. mybot@clawaimail.com)
- Send and receive real emails via API
- Real-time notifications via WebSocket and Webhooks
- MCP Server for Claude, Cursor, and other AI tools
- SDKs for Node.js and Python
- Custom domain support
- Thread tracking and email search
## API Base URL
https://api.clawaimail.com
## Authentication
All API requests require a Bearer token:
```
Authorization: Bearer pb_your_api_key
```
Get your API key by registering at https://clawaimail.com and creating one in the dashboard.
## Quick Start
### Create an inbox
POST /v1/inboxes
{"username": "mybot"}
Returns: {"id": 1, "address": "mybot@clawaimail.com"}
### Send an email
POST /v1/messages/send
{"inbox_id": 1, "to": "user@example.com", "subject": "Hello", "text": "Hi from my AI agent!"}
### Read messages
GET /v1/inboxes/1/messages
### Search emails
GET /v1/inboxes/1/search?q=keyword
## MCP Server (for Claude, Cursor, OpenClaw)
Install: npx clawaimail-mcp
Or add to your MCP config:
```json
{
"mcpServers": {
"clawaimail": {
"command": "npx",
"args": ["clawaimail-mcp"],
"env": {
"CLAWAIMAIL_API_KEY": "pb_your_api_key"
}
}
}
}
```
Available MCP tools: list_inboxes, create_inbox, send_email, list_messages, read_email, search_emails, delete_inbox, account_info
## Node.js SDK
```javascript
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@example.com', subject: 'Hello', text: 'Hi!' });
const messages = await mail.listMessages(inbox.id);
```
## Python SDK
```python
from clawaimail import ClawAIMail
mail = ClawAIMail(api_key='pb_xxx')
inbox = mail.crea
OpenAPI Spec (preview)
openapi: 3.1.0
info:
title: ClawAIMail API
description: Email infrastructure for AI agents. Create inboxes, send/receive emails, and manage email programmatically.
version: 1.0.0
contact:
name: ClawAIMail
url: https://clawaimail.com
servers:
- url: https://api.clawaimail.com
description: Production
security:
- bearerAuth: []
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: "API key with prefix pb_"
schemas:
Inbo