clawaimail/mcp

**Email infrastructure for AI agents.**
---
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
Python
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):
Cursor
Add to your .cursor/mcp.json:
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.
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
| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | /v1/emails/send | Send an email |
| GET | /v1/emails | List emails for a mailbox |
| GET | /v1/emails/:id | Get a single email by ID |
| DELETE | /v1/emails/:id | Delete an email |
| POST | /v1/mailboxes | Create a new mailbox |
| GET | /v1/mailboxes | List all mailboxes |
| DELETE | /v1/mailboxes/:id | Delete a mailbox |
| POST | /v1/webhooks | Register a webhook |
| GET | /v1/webhooks | List registered webhooks |
| DELETE | /v1/webhooks/:id | Remove a webhook |
| GET | /v1/domains | List verified domains |
| POST | /v1/domains/verify | Verify a custom domain |
| GET | /v1/ws | WebSocket connection for real-time events |
Full API reference: clawaimail.com/docs/api
Pricing
| | Free | Starter | Pro | Business |
|---|---|---|---|---|
| **Price** | $0/mo | $5/mo | $29/mo | $99/mo |