@multimail/mcp-server

MultiMail 的 MCP 服务器。为您的智能体提供专属电子邮件地址，并配备分级的人工监督功能——从完全审批到自主发送。

快速开始

npx @multimail/mcp-server

设置 MULTIMAIL_API_KEY 以获得完全访问权限，或者在不设置的情况下运行以先创建账户。请在 multimail.dev 获取密钥。

使用 MultiMail 即表示您同意服务条款和可接受使用政策。

Related MCP server: MCP Email Server

设置

选项 A：远程服务器（推荐）

无需安装。直接连接到我们的托管服务器。通过浏览器中的 OAuth 进行身份验证。

{
  "mcpServers": {
    "multimail": {
      "type": "url",
      "url": "https://mcp.multimail.dev/mcp"
    }
  }
}

适用于 Claude.ai、Claude Desktop、Claude Code 以及任何支持远程 MCP 服务器的客户端。

选项 B：本地服务器 (stdio)

在本地运行服务器。API 密钥作为环境变量传递。

{
  "mcpServers": {
    "multimail": {
      "command": "npx",
      "args": ["-y", "@multimail/mcp-server"],
      "env": {
        "MULTIMAIL_API_KEY": "mm_live_...",
        "MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
      }
    }
  }
}

在何处添加此配置

客户端	配置文件
Claude Code	`~/.claude/.mcp.json`
Claude Desktop	`claude_desktop_config.json`
Cursor	项目中的 `.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
Copilot (VS Code)	项目中的 `.vscode/mcp.json`
OpenCode	项目中的 `mcp.json`
ChatGPT Desktop	设置 > MCP 服务器
任何 MCP 客户端	请查阅客户端文档以获取配置位置

环境变量

变量	必需	描述
`MULTIMAIL_API_KEY`	是	您的 MultiMail API 密钥 (`mm_live_...`)
`MULTIMAIL_MAILBOX_ID`	否	默认邮箱 ID。如果未设置，请将 `mailbox_id` 传递给每个工具或先调用 `list_mailboxes`。
`MULTIMAIL_API_URL`	否	API 基础 URL。默认为 `https://api.multimail.dev`。

首次运行设置

首次使用时，MultiMail 将提示您配置邮箱。您也可以使用 configure_mailbox 工具显式运行此操作：

监督模式：需要多少人工审批 (gated_send、monitored、autonomous 等)
显示名称：邮件中显示的发送者名称
抄送/密送默认值：自动抄送所有外发邮件的地址
调度：启用/禁用定时发送并设置默认的把关时间
签名：电子邮件签名块

如果您跳过此步骤，MultiMail 将在您首次调用工具时提醒您。

工具

工具	描述
`list_mailboxes`	列出此 API 密钥可用的所有邮箱
`configure_mailbox`	设置邮箱偏好：监督模式、显示名称、抄送/密送、调度、签名
`send_email`	发送带有 Markdown 正文的电子邮件。支持附件、`idempotency_key` 和用于定时发送的 `send_at`。
`check_inbox`	使用过滤器列出邮件：状态、发送者、主题、日期范围、方向、附件、游标分页
`read_email`	获取完整的电子邮件内容。将受信任的元数据和不受信任的正文作为单独的内容块返回。
`reply_email`	回复现有会话中的邮件。支持附件和 `idempotency_key`。
`download_attachment`	以 base64 格式下载带有内容类型的电子邮件附件
`get_thread`	获取会话中的所有邮件，包含参与者和元数据
`cancel_message`	取消待处理或已调度的邮件
`schedule_email`	安排未来发送的邮件，需要 `send_at` 时间。在发送前可编辑或取消。
`edit_scheduled_email`	在发送前编辑已调度邮件的发送时间、收件人、主题或正文
`update_mailbox`	更新邮箱设置（显示名称、监督模式、签名、Webhook）
`update_account`	更新账户设置（组织名称、监督邮箱、实际地址）
`delete_mailbox`	永久删除邮箱（需要管理员权限）
`request_challenge`	请求用于账户创建的 ALTCHA 工作量证明挑战（无需 API 密钥）
`create_account`	使用已解决的 PoW 挑战创建新账户（无需 API 密钥）
`resend_confirmation`	使用新代码重新发送激活邮件（无需 API 密钥）
`activate_account`	使用确认邮件中的代码激活账户（无需 API 密钥）
`tag_email`	设置、获取或删除邮件上的键值标签（持久化智能体记忆）
`add_contact`	将联系人添加到地址簿，可选择添加标签
`search_contacts`	按姓名或电子邮件搜索地址簿
`get_account`	获取账户状态、套餐、配额、发送启用情况、执行层级
`create_mailbox`	创建新邮箱（需要管理员权限）
`request_upgrade`	请求监督模式升级（信任阶梯）
`apply_upgrade`	应用来自操作员的升级代码
`get_usage`	检查计费周期的配额和使用统计信息
`list_pending`	列出等待监督决策的邮件（需要监督权限）
`decide_email`	批准或拒绝待处理的邮件（需要监督权限）
`delete_contact`	从地址簿中删除联系人
`check_suppression`	列出被抑制的电子邮件地址
`remove_suppression`	从抑制列表中删除地址
`list_api_keys`	列出所有 API 密钥（需要管理员权限）
`create_api_key`	创建带有作用域的新 API 密钥（需要管理员权限 + 操作员批准；拒绝 `send`+`oversight` 组合以防止自我批准）
`revoke_api_key`	撤销 API 密钥（需要管理员权限）
`get_audit_log`	获取账户审计日志（需要管理员权限）
`delete_account`	永久删除账户及所有数据（需要管理员权限）
`wait_for_email`	阻塞直到收到符合过滤器的新邮件，或超时（最长 120 秒）
`create_webhook`	为实时电子邮件事件通知创建 Webhook 订阅
`list_webhooks`	列出此账户的所有 Webhook 订阅
`delete_webhook`	删除 Webhook 订阅

工作原理

您以 markdown 编写邮件正文。MultiMail 会将其转换为格式化的 HTML 进行投递。
收到的邮件以 整洁的 markdown 呈现。无需 HTML 解析或 MIME 解码。
会话是自动处理的。回复邮件时，标题会被正确设置。
发送时会返回 pending_scan 状态，同时对邮件进行威胁扫描。如果您的邮箱使用把关监督，状态将转换为 pending_send_approval 以供人工审核。请勿重试或重新发送。
通过检查接收邮件上的 X-MultiMail-Identity 签名头来验证其他智能体。

开发

npm install
npm run dev   # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start     # Run compiled version

测试

echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js

许可证

MIT

MultiMail

@multimail/mcp-server

快速开始

设置

选项 A：远程服务器（推荐）

选项 B：本地服务器 (stdio)

在何处添加此配置

环境变量

首次运行设置

工具

工作原理

开发

测试

许可证

Resources

Tools

Latest Blog Posts

MCP directory API