Claw Ai Mail

ClawAIMail

AI エージェント向けのメールインフラストラクチャです。

---

ClawAIMail を使うと、AI エージェントが独自のメールアドレスを持ち、メールの送信、受信、管理をプログラムから完全に制御できます。エージェント型ワークフローで信頼性の高いメール機能を必要とする開発者向けに構築されています。

特長

• REST API -- シンプルな JSON API でメールの送信、受信、検索、管理ができます。
• MCP サーバー -- Claude、Cursor、その他の MCP 対応クライアント向けの、Model Context Protocol を第一級でサポートするサーバーです。
• WebSocket ストリーミング -- メールイベントの発生時に、リアルタイムでエージェントに配信します。
• Webhook -- 受信メール、配信状況、その他のイベントに対する HTTP コールバックです。
• カスタムドメイン -- 独自のドメインを使用するか、@clawaimail.com のアドレスを利用できます。
• SDK -- 迅速に統合できる公式の Node.js および Python SDK です。

クイックスタート

Node.js

npm install clawaimail

const { ClawAIMail } = require("clawaimail");

const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });

// Create a mailbox for your agent
const mailbox = await client.mailboxes.create({
  name: "support-agent",
  domain: "clawaimail.com",
});

// Send an email
await client.emails.send({
  from: mailbox.address,
  to: "[email protected]",
  subject: "Hello from my AI agent",
  text: "This email was sent by an autonomous agent.",
});

// List incoming emails
const inbox = await client.emails.list({
  mailbox: mailbox.id,
  unread: true,
});

Python

pip install clawaimail

from clawaimail import ClawAIMail

client = ClawAIMail(api_key="your-api-key")

# Create a mailbox
mailbox = client.mailboxes.create(name="support-agent", domain="clawaimail.com")

# Send an email
client.emails.send(
    from_address=mailbox.address,
    to="[email protected]",
    subject="Hello from my AI agent",
    text="This email was sent by an autonomous agent.",
)

# List incoming emails
inbox = client.emails.list(mailbox=mailbox.id, unread=True)

MCP サーバー

ClawAIMail には MCP サーバーが付属しているため、Claude、Cursor、その他の MCP 対応クライアントでメールツールを直接利用できます。

Claude Desktop

以下を Claude Desktop の MCP 設定（claude_desktop_config.json）に追加します。

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

Cursor

.cursor/mcp.json に追加します。

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

設定すると、エージェントは追加のコードなしで、send_email、read_inbox、search_emails、create_mailbox などのツールを呼び出せるようになります。

セルフホスト

ClawAIMail はセルフホストでき、メールインフラストラクチャを完全に制御できます。

# Clone the repository
git clone https://github.com/joansongjr/clawaimail.git
cd clawaimail

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your SMTP credentials, database URL, and API keys

# Run database migrations
npm run db:migrate

# Start the server
npm start

サーバーはデフォルトで http://localhost:3000 から利用できます。本番環境へのデプロイガイド（Docker、Railway、Fly.io）については、セルフホストのドキュメントをご覧ください。

API エンドポイント

メソッド	エンドポイント	説明
POST	/v1/emails/send	メールを送信します
GET	/v1/emails	メールボックスのメール一覧を取得します
GET	/v1/emails/:id	ID で指定したメールを取得します
DELETE	/v1/emails/:id	メールを削除します
POST	/v1/mailboxes	新しいメールボックスを作成します
GET	/v1/mailboxes	すべてのメールボックスの一覧を取得します
DELETE	/v1/mailboxes/:id	メールボックスを削除します
POST	/v1/webhooks	Webhook を登録します
GET	/v1/webhooks	登録済みの Webhook の一覧を取得します
DELETE	/v1/webhooks/:id	Webhook を削除します
GET	/v1/domains	検証済みドメインの一覧を取得します
POST	/v1/domains/verify	カスタムドメインを検証します
GET	/v1/ws	リアルタイムイベント用の WebSocket 接続です

API リファレンス全文：clawaimail.com/docs/api

料金

	Free	Starter	Pro	Business
料金	$0/mo	$5/mo	$29/mo	$99/mo
月間メール数	100	5,000	50,000	500,000
メールボックス数	1	10	100	無制限
カスタムドメイン	--	1	5	無制限
Webhook	1	5	25	無制限
WebSocket	--	はい	はい	はい
サポート	コミュニティ	メール	優先対応	専任対応

セルフホスト環境でのデプロイは無料で、利用制限もありません。詳細はclawaimail.com/pricingをご覧ください。

リンク

• ドキュメント
• Node.js SDK
• Python SDK
• ウェブサイト
• ステータスページ

ライセンス

MIT -- 詳細は LICENSE をご覧ください。