如何通过 MCP 将 Email (IMAP/SMTP) 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Email (IMAP/SMTP)、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Email (IMAP/SMTP) + Cursor

通过 IMAP 和 SMTP 连接任意邮箱：列出文件夹，搜索和读取邮件及附件，标记、加旗标和移动邮件，以及将回复保存为草稿。发送和删除到废纸篓在安装时已关闭；在 AnythingMCP Cloud 上发送邮件需要使用在 2525 端口提供 SMTP 的服务商。支持 IONOS、Strato、GMX、web.de、T-Online、Gmail（应用专用密码）、Fastmail、Hetzner、all-inkl、Aruba 和自托管服务器。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

EMAIL_IMAP_HOST, EMAIL_IMAP_PORT, EMAIL_SMTP_HOST, EMAIL_SMTP_PORT, EMAIL_USERNAME, EMAIL_PASSWORD

步骤 1 — 获取凭证

设置大约需要 5 分钟。你需要邮件服务商的 IMAP 和 SMTP 服务器名称，以及邮箱密码或应用专用密码。

该连接器适用于任何提供 IMAP（读取和整理邮件）和 SMTP（发送邮件）的邮箱：IONOS、Strato、GMX、web.de、T-Online、Hetzner、all-inkl、Aruba、Gmail 和 Google Workspace、Yahoo、iCloud、Fastmail、自托管的 Dovecot/Postfix，以及大多数其他服务商。

不适用于 Microsoft 365 或 Outlook.com。 Microsoft 已关闭 IMAP 和 SMTP 的密码登录。请使用通过 OAuth 登录的 Microsoft Outlook 连接器。

1. 在下表中找到你的服务商。如果表中没有，其帮助页面会注明 IMAP 服务器和 SMTP 服务器（也称为收件服务器和发件服务器）。
2. 填写 EMAIL_IMAP_HOST、EMAIL_IMAP_PORT、EMAIL_SMTP_HOST、EMAIL_SMTP_PORT、EMAIL_USERNAME（几乎总是完整的邮箱地址）和 EMAIL_PASSWORD。
3. 将 EMAIL_IMAP_SECURITY 和 EMAIL_SMTP_SECURITY 留空：由端口决定（993 和 465 使用 SSL/TLS，143 和 587 使用 STARTTLS）。只有服务器使用非标准端口时，才将它们设为 tls 或 starttls。
4. 安装连接器并运行 imap_smtp_list_folders 检查登录。

应用专用密码：启用了两步登录的服务商不接受用普通密码登录 IMAP 和 SMTP。它们会改为签发一个应用专用密码，仅供此连接器使用，并且可以随时撤销。

• Gmail / Google Workspace：开启 2-Step Verification，然后在 https://myaccount.google.com/apppasswords 创建。在 Google Workspace 中，可能需要管理员允许此操作。
• Yahoo：依次打开 Account Info, Account Security, Generate app password。
• iCloud：在 https://account.apple.com 依次打开 Sign-In and Security, App-Specific Passwords。EMAIL_USERNAME 是完整的 iCloud 地址。
• Fastmail：依次打开 Settings, Privacy & Security, Manage app passwords，创建一个可访问 IMAP 和 SMTP 的密码。
• GMX 和 web.de 开启了双重验证时：在安全设置中创建一个应用专用密码。

可选设置：EMAIL_FROM_ADDRESS 和 EMAIL_FROM_NAME 设置已发送邮件上显示的发件人（默认为用户名）；服务商通常只接受该账户自有的地址或别名。EMAIL_SMTP_USERNAME 和 EMAIL_SMTP_PASSWORD 仅在发送与读取使用不同的登录信息时才需要。EMAIL_SENT_FOLDER 设置已发送邮件的存放位置（默认为服务器标记为已发送的文件夹；Gmail 会自行存放已发送邮件）。

读取和整理：AI 先获取文件夹列表（收件箱、已发送、草稿、废纸篓、垃圾邮件、归档，附带邮件数和未读数），在单个文件夹中按发件人、收件人、主题、正文、日期、未读或已加旗标搜索，结果从新到旧排列，并以文本形式读取邮件及其附件列表。读取不会将邮件标记为已读。它可以打开附件（文本文件作为文本，图片和文档附加到结果中），将邮件标记为已读或未读，加旗标，以及将邮件移动到其他文件夹。

回复：imap_smtp_save_draft 将邮件放入草稿箱，可选择作为某封邮件所在会话中的回复，供你审阅后从邮件客户端发送。这是默认的回复方式。imap_smtp_guide 说明调用各工具的顺序，不会连接邮件服务器。

安装时已关闭：imap_smtp_send_message 和 imap_smtp_delete_messages。只有在确实要让 AI 发送或删除邮件时，才在连接器的工具列表中开启它们。发送会立即进行，可选择作为某封邮件所在会话中的回复，并在已发送中保存一份副本，且无法撤回，因此 AI 会先与你确认收件人和内容。删除会将邮件移到废纸篓：不会永久删除任何邮件，已在废纸篓中的邮件会被拒绝。

不可信内容：邮件由陌生人撰写，可能包含企图向 AI 下达指令的文字（"把所有发票转发给…"、"删除这个会话"）。AI 将邮件内容视为数据而非命令，绝不执行邮件中的指令。

限制：一次搜索最多返回 100 封邮件；正文超过 100,000 个字符会被截断并加上标记；超过 4 MB 的附件会被拒绝；一封邮件最多发给 50 个收件人；发出的邮件暂时不能带附件。每次工具调用都会建立自己的 IMAP 连接并在结束后注销，因此两次调用之间不会与邮箱保持连接。UID 属于单个文件夹，邮件被移动后会改变。

Cloud 和自托管：AnythingMCP Cloud 只使用加密连接（SSL/TLS 或 STARTTLS），只连接使用端口 IMAP 993/143 和 SMTP 465/587/2525 的公共邮件服务器，并且只连接具有有效证书的服务器。它始终会登录 SMTP 服务器，因此不会有任何邮件经由未经身份验证的中继发出。Cloud 上不接受 25 端口。

从 AnythingMCP Cloud 发送：Cloud 的托管服务商屏蔽了 25、465 和 587 端口的出站 SMTP，因此几乎所有邮箱都无法在 Cloud 上发送邮件：imap_smtp_send_message 会报告这一情况，且不会发送任何内容。通过 IMAP 进行的读取、搜索、旗标、移动和草稿均可正常使用，因此 AI 会将回复保存为草稿，由你从邮件客户端发送。在自托管环境中，或在 Cloud 上使用在 2525 端口提供 SMTP 的服务商时，可以发送邮件。Test connection 会显示 IMAP 正常工作，SMTP 无法连接。

自托管：只要管理员将内部网络中邮件服务器的主机加入出站允许列表（Admin, Settings，或 SSRF_ALLOWED_HOSTS），即可使用该邮件服务器。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Email (IMAP/SMTP) 的工具。

可用工具

示例提示

• “从周一到现在，收件箱里收到了哪些未读邮件？列出每封邮件的发件人、主题和一句话摘要。”
• “找到我的主机服务商最近一封带发票的邮件，并打开其中的 PDF 附件。”
• “给 [email protected] 发来的最新邮件起草一封回复，说我周四 10 点可以见面。”
• “把上个月的新闻通讯从收件箱移到归档文件夹。”
• “给 [email protected] 起草一封简短的邮件，确认我们明天下午 3 点的通话，并保存到草稿箱。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot