MCP Server Imap

@aiwerk/mcp服务器imap

](https://www.npmjs.com/package/@aiwerk/mcp-server-imap) ](https://www.npmjs.com/package/@aiwerk/mcp-server-imap) 

可与任何电子邮件提供商配合使用的IMAP/SMTP MCP服务器。 设置主机、用户、pass-old。

与仅限Gmail或仅限Outlook的MCP服务器不同，这款服务器使用标准的IMAP/SMTP，因此可以与 每 电子邮件提供商开箱即用。

为什么是这个服务器？

大多数电子邮件MCP服务器只能与一个提供商（Gmail、Outlook）配合使用。这个与 任何 支持IMAP的提供商：

• Gmail、Outlook、雅虎——是的
• Fastmail、ProtonMail Bridge、Zoho——是的
• 自托管（Dovecot、Postfix、hMailServer）--是
• 公司/托管（Hostpoint、Infomaniak、OVH）--是

一台服务器，每个邮箱。

亮点

• 通用 --标准IMAP/SMTP，适用于任何地方
• 简单设置 --只是 IMAP_HOST, IMAP_USER, IMAP_PASS 你已连接
• 安全第一 --电子邮件发送是 默认情况下禁用 (SMTP_SEND_ENABLED=false).您的AI代理可以阅读电子邮件，但在您明确选择加入之前无法发送任何内容
• 懒惰凭据 --服务器启动并公开其工具列表，而不需要凭据。只有在实际调用工具时才需要Auth
• 真正的MIME解析 --处理多部分、HTML/文本、附件、回复线程

AIWerk托管服务-- email_send 和 email_reply 仅限于本地

如果您通过AIWerk托管服务使用此服务器，请访问 aiwerkmcp.com，两个外发邮件工具未公开：

• ❌ email_send
• ❌ email_reply

其他8个读取端工具(email_list, email_read, email_search, email_folders, email_flag, email_move, email_delete, email_attachment)在托管服务上正常工作。

为什么？ 托管服务在所有用户之间共享IP。如果传出的邮件从该共享IP发出，则该IP将出现在每个收件人的 Received: headers——一个不良行为者可能会损害每个用户的可交付性。没有共享的IP架构，任意用户发送都可以安全工作。

那么，如何发送邮件呢？ 在本地运行服务器，其中传出的邮件来自您自己的IP和您自己的提供商声誉。三条路径：

1. 即席电子邮件CLI --请参阅下一节。零配置，一枪。
2. 直接stdio MCP服务器 在您的客户端（Cursor、Claude Desktop、OpenClaw）中，将您的客户端配置指向 npx -y @aiwerk/mcp-server-imap 和你一起 IMAP_* 和 SMTP_* env变量包括 SMTP_SEND_ENABLED=true.
3. 本地 @aiwerk/mcp-bridge — npx -y @aiwerk/mcp-bridge install imap-email --catalog aiwerkmcp.com，然后将客户端指向本地网桥端点。

在这三种情况下，邮件都来自您的家庭/办公室IP，而不是来自托管服务。

即席电子邮件CLI

注： 在AIWerk托管的服务上 email_send 和 email_reply MCP工具没有公开（该服务在所有用户之间共享一个IP，因此允许任意发送将危及每个用户的可送达性）。使用以下三条路径中的任何一条在本地发送电子邮件。

需要从命令行发送一封电子邮件吗？例如，要交付您的AI代理编写的草稿？使用 aiwerk-send-email:

SMTP_HOST=smtp.gmail.com \
SMTP_PORT=587 \
SMTP_USER=me@gmail.com \
SMTP_PASS='app-password' \
SMTP_FROM='Me ' \
npx -y @aiwerk/mcp-server-imap aiwerk-send-email \
  --to "alice@example.com" \
  --subject "Re: invoice" \
  --body "Got it, will pay Monday."

成功后，退出0并打印JSON： {"ok":true,"messageId":"...","envelope":{...}}

失败时，退出1，stderr上出现错误。凭证从不打印。

所有CLI参数

CLI环境变量

______________________________________________________________________

安装

获取电子邮件工具的三种方法——选择一种合适的。

1.快速（单封电子邮件） — aiwerk-send-email 上面的CLI：不需要MCP客户端，一个命令发送一封电子邮件。

2.直接stdio MCP服务器 --所有10个暴露给您的AI代理的电子邮件工具：

npx -y @aiwerk/mcp-server-imap

3.带有目录UX的本地网桥 --通过AIWerk目录进行安装，以获得指导设置：

npx -y @aiwerk/mcp-bridge install imap-email --catalog bridge.aiwerk.ch

选项1——托管（零设置）

没有本地运行时，您的计算机上没有环境变量——凭据是通过HashiCorp Vault在服务器端进行AES-256-GCM加密的。

1. 注册地址： aiwerkmcp.com.
2. 安装 IMAP电子邮件 从目录中复制并粘贴您的IMAP/SMTP凭据。
3. 将您的MCP客户端（Claude.ai、Cursor、Hermes等）指向您的托管端点：

   https://bridge.aiwerk.ch/u//mcp

用你的Bearer代币。

所有10个工具立即出现。从同一网桥安装其他AIWerk配方。

选项2——自托管（npx）

直接运行--您可以管理凭据：

IMAP_HOST="imap.example.com" \
IMAP_USER="user@example.com" \
IMAP_PASS="app-password" \
SMTP_HOST="smtp.example.com" \
npx @aiwerk/mcp-server-imap

服务器立即启动并响应 tools/list 即使没有凭据——只有在实际调用工具时才需要它们（懒惰凭据）。

工具（10）

配置

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": ["-y", "@aiwerk/mcp-server-imap"],
      "env": {
        "IMAP_HOST": "imap.example.com",
        "IMAP_USER": "you@example.com",
        "IMAP_PASS": "your-app-password",
        "SMTP_HOST": "smtp.example.com"
      }
    }
  }
}

光标/风帆/VS代码

各个MCP设置中的配置格式相同。

AIWerk托管服务

如果你想要零设置，请通过安装 aiwerkmcp.com --看 选项1 上面。

环境变量

IMAP（必填）

SMTP（可选，用于发送）

调试

安全

• 电子邮件发送是 默认情况下禁用 --set SMTP_SEND_ENABLED=true 启用
• 凭据加载缓慢（仅在调用工具时，而不是在启动时）
• 没有记录凭据
• 将凭据保存在 .env 或者秘密经理——永远不要把他们交给git

支持的提供商

测试工具：Hostpoint、Gmail（应用程序密码）、Outlook/Microsoft 365、雅虎邮箱、Fastmail、Dovecot、Postfix。

适用于任何符合标准的IMAP/SMTP服务器。

从源代码构建

git clone https://github.com/AIWerk/mcp-server-imap
cd mcp-server-imap
npm install
npm run build
node dist/server.js

贡献

欢迎发布问题和PR！请先打开一个问题以进行更大的更改。

更新日志

看 更改日志.md 版本历史。

关于AIWerk MCP

其他AIWerk MCP服务器：

• @aiwerk/mcp-server-cal --Cal.com日程安排
• @aiwerk/mcp服务器端 -Wise（TransferWise）个人API，只读
• @aiwerk/mcp服务器clawhub --ClawHub技能目录

浏览完整目录（20多种食谱，包括GitHub、Linear、Notion、Stripe等） aiwerkmcp.com.

许可证

麻省理工学院-- 工作