AI Mail MCP

AI Mail MCP

通过 MCP 为 AI Agent 提供真正的电子邮件。 添加域名并获取准确的 DNS 记录，创建邮箱，在所有邮箱中查看统一收件箱，等待注册验证码和魔法链接，还可以发送、在邮件线程中回复和转发。令牌限定可访问的邮箱，并设有发送权限和每日上限；每次写入操作都可试运行，每次调用都会记录审计日志。

• 网站和完整工具参考：https://aimailmcp.com
• MCP 端点（远程，Streamable HTTP）：https://aimailmcp.com/mcp
• 官方 MCP 注册表：com.aimailmcp/mail
• 机器可读的工具注册表：https://aimailmcp.com/tools.json

此仓库包含公开文档、server.json 和徽标。服务托管在云端；无需在本地安装或运行任何内容。

连接

Claude Code

claude mcp add --transport http aimail https://aimailmcp.com/mcp

Claude.ai 和 Claude Desktop： 依次选择 Settings、Connectors、Add custom connector，然后粘贴 https://aimailmcp.com/mcp。

任何 MCP 客户端

{
  "mcpServers": {
    "aimail": { "type": "http", "url": "https://aimailmcp.com/mcp" }
  }
}

不支持远程连接的客户端可通过 stdio 建立桥接：npx -y mcp-remote https://aimailmcp.com/mcp。 面向 Agent 的安装步骤：llms-install.md。

登录

• OAuth 2.1（大多数客户端会自动完成）：动态客户端注册和 PKCE。输入电子邮件地址后，我们会向你发送一个 6 位验证码。
• Bearer 令牌（适用于没有浏览器的 Agent）：

curl -X POST https://aimailmcp.com/api/v1/signup -H 'content-type: application/json' -d '{"email":"[email protected]"}'
curl -X POST https://aimailmcp.com/api/v1/signup/confirm -H 'content-type: application/json' -d '{"email":"[email protected]","code":"123456"}'

然后发送 Authorization: Bearer amk_...。使用 create_token 为其他 Agent 创建权限范围更窄的令牌。

工具

域名

添加域名，获取准确的 DNS 记录并进行验证。

工具	功能
add_domain	将域名（或子域名）添加到此账户，以便为其创建邮箱。
get_dns_plan	列出域名收发邮件所需的准确 DNS 记录（MX、SPF、DKIM、DMARC、所有权 TXT），并显示每项记录是否已就绪。
apply_dns	将 DNS 配置写入此服务 Cloudflare 账户管理的域名：启用 Email Routing（MX + SPF）、将邮件路由到接收端、为域名注册发送功能，并添加 DKIM 和 DMARC。
verify_domain	检查域名的实时 DNS：所有权 TXT（外部域名）、MX、SPF、DMARC，以及发送服务商的 DKIM 状态。
list_domains	列出此账户的所有域名及其状态、模式、发送就绪情况和邮箱数量。
remove_domain	从此账户中移除域名。

邮箱

用于收发邮件的地址，以及别名、全收地址和转发功能。

工具	功能
create_mailbox	在此账户的一个域名上创建邮箱（可收发邮件的地址）。
list_mailboxes	列出此令牌可查看的所有邮箱，以及未读数量、最近收件时间、别名、转发设置和路由地址。
delete_mailbox	删除邮箱。
add_alias	将发送到此账户某个域名上的其他地址的邮件投递到现有邮箱。
set_catch_all	将域名上发往任意未知地址的邮件投递到一个邮箱，或传入 mailbox: null 以关闭全收功能。
set_forwarding	将邮箱收到的每封邮件同时转发到最多 5 个外部地址（原邮件将作为 message/rfc822 附件）。

阅读

一个统一收件箱，涵盖令牌可访问的所有邮箱。

工具	功能
list_messages	汇总令牌可访问的所有邮箱中的邮件，按最新优先排列，并为每封邮件标注所属邮箱。
search_messages	在令牌可访问的所有邮箱中搜索主题、发件人、收件人和正文的全文（默认搜索所有文件夹）。
get_message	获取一封邮件的邮件头、文本正文（或由 HTML 转换而来的文本）、提取的链接、附件列表和会话 ID。
get_thread	获取邮件所属会话的完整内容，包括收件和发件邮件，按时间从早到晚以预览形式排列。
wait_for_message	阻塞等待符合条件的邮件到达（或等待 timeout_s，最长 60 秒，默认 25 秒），并完整返回该邮件。
get_attachment	以 base64 格式获取一个附件（最大 5 MB）。
mark_read	将最多 100 封邮件标记为已读（或通过 read: false 标记为未读）。
label	为最多 100 封邮件添加和/或移除标签。
archive	将最多 100 封邮件移出收件箱并归档（或通过 unarchive: true 移回收件箱）。

发送

发送、在会话中回复、转发和创建草稿，均受各令牌的独立权限控制。

工具	功能
send_message	从已授权范围内的邮箱发送新邮件（或通过 draft_id 发送已保存的草稿）。
reply	从收到该邮件的邮箱在会话中回复（设置 In-Reply-To 和 References，只添加一次“Re:”，并引用原邮件）。
forward	将邮件（含其附件）转发给新收件人，并可在顶部添加备注。
create_draft	在邮箱中保存草稿（存放于 drafts 文件夹），供人工或其他 Agent 审阅。

自动化

邮件到达或发送完成时，通过签名 Webhook 发送通知。

工具	功能
create_webhook	邮件到达或发送完成时，向你的 https URL POST 一个签名 JSON 事件。
list_webhooks	列出此账户的 Webhook，包括其事件、范围和最近一次投递状态。
delete_webhook	停止并移除 Webhook。

访问权限

为其他 Agent 创建范围受限的令牌，并查看审计日志。

工具	功能
create_token	为其他 Agent 创建令牌，可限定其邮箱范围（默认：全部邮箱），可设置是否允许发送邮件以及每日发送上限。
list_tokens	列出此账户的令牌：标签、前缀、范围、发送权限、上限和最近使用时间。
revoke_token	根据 ID 或前缀撤销令牌。
audit_log	查看此账户最近的工具调用（包括所有尝试，含拒绝和空运行）：工具、结果、令牌和时间。
get_usage	查看此令牌的用量：发送量和收件人数、收件邮件、存储 GB-days 以及工具调用，并按操作或日期列出各项费用。管理员令牌可查询整个账户；委派令牌可查询单个终端客户。

完整架构：https://aimailmcp.com/tools.json

安全模型

• 入站邮件仅通过我们的 Cloudflare 邮件 Worker 以 HMAC-SHA256 签名的原始邮件形式到达服务；未签名的请求将被拒绝。
• 发件人控制的所有内容都会放在 untrusted_external_content 信封中返回。Agent 应将邮件视为数据，而非指令。
• 令牌以哈希形式存储，范围限定到邮箱，且绝不能创建权限更高的令牌。
• 隐私政策：https://aimailmcp.com/privacy · 联系方式：[email protected]

许可证

本仓库内容（文档、徽标、server.json）采用 MIT 许可证。托管服务由 Hapi 运营。