---

name: clawaimail version: 0.2.0 description: Email infrastructure for AI agents — create inboxes, send and receive real emails, search messages, manage threads. Alternative to AgentMail with MCP server, REST API, webhooks, and WebSocket streaming. author: ClawAIMail author_url: https://clawaimail.com repository: https://github.com/joansongjr/clawaimail license: MIT tags:

• email
• inbox
• send-email
• receive-email
• ai-agent
• mcp-server
• mcp
• api
• automation
• email-agent
• mailbox
• webhook
• smtp

---

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 mybot@clawaimail.com
• 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

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

CLAWAIMAIL_API_KEY=pb_your_api_key

MCP Server Configuration

{
  "mcpServers": {
    "clawaimail": {
      "command": "npx",
      "args": ["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. mybot@clawaimail.com)
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: assistant@clawaimail.com

User: Send an email to john@example.com saying hello
Agent: [calls send_email with to "john@example.com", 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: jane@company.com - Subject: "Meeting tomorrow"
       2. From: support@service.com - Subject: "Your ticket #1234"
       3. From: newsletter@tech.io - 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: billing@vendor.com - "Invoice #5678 - Due March 15"
       2. From: accounting@partner.org - "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

Links

• Website: https://clawaimail.com
• API Docs: https://clawaimail.com/docs/
• GitHub: https://github.com/joansongjr/clawaimail
• Node.js SDK: npm install clawaimail
• Python SDK: pip install clawaimail