io.github.joansongjr/clawaimail

平台与服务

by joansongjr

面向 AI agents 的邮件基础设施,可创建 inboxes、收发 email,并搜索消息内容。

什么是 io.github.joansongjr/clawaimail

面向 AI agents 的邮件基础设施,可创建 inboxes、收发 email,并搜索消息内容。

README

ClawAIMail

Email infrastructure for AI agents.

npm version License: MIT Documentation


ClawAIMail gives AI agents their own email addresses and full programmatic control over sending, receiving, and managing email. Built for developers who need reliable email primitives in agentic workflows.

Features

  • REST API -- Send, receive, search, and manage emails with a simple JSON API.
  • MCP Server -- First-class Model Context Protocol server for Claude, Cursor, and other MCP-compatible clients.
  • WebSocket Streaming -- Real-time email events pushed to your agent as they happen.
  • Webhooks -- HTTP callbacks on incoming mail, delivery status, and other events.
  • Custom Domains -- Bring your own domain or use a @clawaimail.com address.
  • SDKs -- Official Node.js and Python SDKs for rapid integration.

Quick Start

Node.js

bash
npm install clawaimail
javascript
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: "user@example.com",
  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

bash
pip install clawaimail
python
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="user@example.com",
    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 Server

ClawAIMail ships an MCP server so that Claude, Cursor, and other MCP-compatible clients can use email tools directly.

Claude Desktop

Add the following to your Claude Desktop MCP config (claude_desktop_config.json):

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

Cursor

Add to your .cursor/mcp.json:

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

Once configured, the agent can call tools like send_email, read_inbox, search_emails, and create_mailbox without any additional code.

Self-Hosting

ClawAIMail can be self-hosted for full control over your email infrastructure.

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

The server will be available at http://localhost:3000 by default. See the self-hosting docs for production deployment guides (Docker, Railway, Fly.io).

API Endpoints

MethodEndpointDescription
POST/v1/emails/sendSend an email
GET/v1/emailsList emails for a mailbox
GET/v1/emails/:idGet a single email by ID
DELETE/v1/emails/:idDelete an email
POST/v1/mailboxesCreate a new mailbox
GET/v1/mailboxesList all mailboxes
DELETE/v1/mailboxes/:idDelete a mailbox
POST/v1/webhooksRegister a webhook
GET/v1/webhooksList registered webhooks
DELETE/v1/webhooks/:idRemove a webhook
GET/v1/domainsList verified domains
POST/v1/domains/verifyVerify a custom domain
GET/v1/wsWebSocket connection for real-time events

Full API reference: clawaimail.com/docs/api

Pricing

FreeStarterProBusiness
Price$0/mo$5/mo$29/mo$99/mo
Emails/month1005,00050,000500,000
Mailboxes110100Unlimited
Custom domains--15Unlimited
Webhooks1525Unlimited
WebSocket--YesYesYes
SupportCommunityEmailPriorityDedicated

Self-hosted deployments are free and unlimited. See clawaimail.com/pricing for details.

Links

License

MIT -- see LICENSE for details.

常见问题

io.github.joansongjr/clawaimail 是什么?

面向 AI agents 的邮件基础设施,可创建 inboxes、收发 email,并搜索消息内容。

相关 Skills

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描165.3k

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描165.3k

接口测试套件

by alirezarezvani

Universal
热门

扫描 Next.js、Express、FastAPI、Django REST 的 API 路由,自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。

帮你把API与集成测试自动化跑顺,减少回归漏测;能力全面,尤其适合复杂接口场景的QA团队。

平台与服务
未扫描23.5k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
89.1k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
79.9k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
71.9k

评论