# Clawaimail

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

- Skill: `dvcrn/clawaimail-2` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add dvcrn/clawaimail-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/clawaimail-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/dvcrn/clawaimail-2

---


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