ClawAIMail - Email for AI Agents

Give your AI agent its own email address. Create inboxes, send and receive real emails, search messages, and manage threads — all through a simple API.

What it does

Create Inboxes: Instantly create email addresses like [email protected]
Send Emails: Send real emails from your agent's address
Receive Emails: Get notified when emails arrive via webhook or WebSocket
Read & Search: Read messages, search by keyword, track threads
Manage: Labels, custom domains, and more

Setup

Get your API key at https://clawaimail.com (free tier: 3 inboxes, 3K emails/month)
Set your environment variable:

CLAWAIMAIL_API_KEY=pb_your_api_key

OpenClaw Configuration

⚠️ Important: Do NOT add mcpServers to openclaw.json — that field is not supported and will crash the Gateway.

Use mcporter (OpenClaw's MCP management tool) to configure:

# Add ClawAIMail as an MCP server
mcporter config add clawaimail "npx -y clawaimail-mcp" --env CLAWAIMAIL_API_KEY="pb_your_api_key"

# Test it works
mcporter call clawaimail.list_inboxes

# Check status
mcporter status

mcporter manages its own config at ~/.openclaw/config/mcporter.json, separate from the OpenClaw Gateway config.

Troubleshooting

Problem	Cause	Fix
Gateway crashes on startup	`mcpServers` added to `openclaw.json`	Remove it from `openclaw.json`, use `mcporter` instead
"CLAWAIMAIL_API_KEY not set" warning	Missing env var	Add `--env CLAWAIMAIL_API_KEY="..."` to mcporter config
API calls return errors	Invalid API key or service unreachable	Check key at https://clawaimail.com/dashboard

MCP Server Configuration (Claude Desktop / Cursor)

For non-OpenClaw MCP clients:

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

Available Tools

Tool	Description
`list_inboxes`	List all your email inboxes
`create_inbox`	Create a new email inbox (e.g. [email protected])
`send_email`	Send an email from an inbox
`list_messages`	List messages in an inbox
`read_email`	Read a specific email message
`search_emails`	Search emails by keyword
`delete_inbox`	Delete an inbox and all its messages
`account_info`	Get account info, plan limits, and usage

Example Usage

Create an inbox and send an email

User: Create an email inbox called "assistant"
Agent: [calls create_inbox with username "assistant"]
       Created inbox: [email protected]

User: Send an email to [email protected] saying hello
Agent: [calls send_email with to "[email protected]", subject "Hello", text "Hello from your AI assistant!"]
       Email sent successfully.

Check for new messages

User: Check my inbox for new messages
Agent: [calls list_messages with inbox_id 1, unread true]
       You have 3 unread messages:
       1. From: [email protected] - Subject: "Meeting tomorrow"
       2. From: [email protected] - Subject: "Your ticket #1234"
       3. From: [email protected] - Subject: "Weekly digest"

Search emails

User: Find any emails about invoices
Agent: [calls search_emails with query "invoice"]
       Found 2 emails mentioning "invoice":
       1. From: [email protected] - "Invoice #5678 - Due March 15"
       2. From: [email protected] - "Updated invoice attached"

Pricing

Free: 3 inboxes, 3K emails/month
Starter ($5/mo): 10 inboxes, 5K emails/month
Pro ($29/mo): 50 inboxes, 50K emails/month, custom domains
Business ($99/mo): 200 inboxes, 200K emails/month

Changelog

0.1.2

Fix: Added error handling to all API calls (no more crashes on missing API key or network errors)
Fix: Accept both number and string IDs for inbox_id/message_id
Added startup warning when CLAWAIMAIL_API_KEY is not set
Added global exception handlers to prevent process crashes

0.1.0

Initial release

clawaimail

Installation