---
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

```json
{
  "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`