Multi Gmail Account MCP

Multi Gmail Account MCP

在 Claude 中同时使用所有邮箱。 此 MCP 服务可连接任意数量的 Gmail 和 IMAP 账户，因此你可以询问 “所有邮箱里有哪些未读邮件？”、“我应该回复谁？” 或 “读取供应商发到店铺收件箱的发票”。Claude 会同时搜索所有邮箱，并告诉你每封邮件来自哪个账户。

为什么选择这个服务

	此服务	Claude 内置的 Gmail	常见 Gmail MCP
账户	Gmail + IMAP，数量不限	1 个	通常为 1 个，或每次调用 1 个
一次搜索所有收件箱	可以，合并并去重	不可以	很少支持
跨账户查找“谁在等我回复？”	可以	不可以	不可以
读取附件中的 PDF、Word、Excel 和图片	可以	部分支持	很少支持
未经允许绝不发送	默认模式（草稿模式）	每次发送时询问	通常可直接发送
登录信息加密，每项操作都有审计日志	可以	不适用	很少支持
可在 claude.ai 网页版和移动端使用	托管模式	可以	很少支持

功能

• 专为多账户设计：
  • 为邮箱设置别名（shop、work、personal）。
  • 一次搜索、摘要和分类所有邮箱，也可以选择其中一个。
  • 两个账户中相同的邮件只显示一次。
• 邮件分类：
  • needs_reply 会按时间从早到晚找出等待你回复的会话。
  • daily_digest 和 /morning-digest 提示词为你生成简报。
  • /reply-queue 逐条起草回复。
• **附件：**无需保存即可读取 PDF（指定页范围、扫描页）、DOCX、XLSX、PPTX、ODT/ODS、RTF、CSV/HTML、.eml 和 ZIP 文件，并让 Claude 查看图片（包含 OCR，也支持希腊语）。
• 撰写（保存为草稿）：
  • 在原会话中回复和回复所有人
  • 转发邮件并附上原始附件
  • Gmail 以此身份发送邮件 地址和签名
  • 本地文件附件
• 整理：
  • 新闻邮件报告和取消订阅
  • 批量归档／标记为已读／添加标签／移至垃圾箱，始终先预览
  • 标签和过滤器
• **日历（可选）：**查看所有账户中的日程、所有日历中的空闲时段，以及创建日程。
• **IMAP：**任何邮箱（Hetzner、cPanel、Fastmail……）都可与 Gmail 并列使用，并支持相同的搜索语法。
• 安全性：
  • 三种模式（readonly、drafts＝绝不发送、full），另有每账户限制
  • 登录信息加密（操作系统钥匙串）
  • 审计日志
  • 拒绝使用错误账户登录
  • 仅对读取操作重试
• **托管模式：**使用 Docker 在小型服务上运行，并将其作为自定义连接器添加到 claude.ai（OAuth 2.1，受密码保护）。

总计 33 个工具。请参阅**工具参考**。

屏幕截图

**需要回复：**所有收件箱中等待你回复的邮件，按时间从早到晚排列。	**附件：**询问 PDF、Office 文件和图片中的内容。
**默认仅保存草稿：**除非切换到完整模式，否则不会发送或删除任何内容。	Gmail 和 IMAP 并列显示，各自使用独立名称。

快速开始

npm install -g multi-gmail-account-mcp

1. Google OAuth 客户端（仅需设置一次）： 创建 Google Cloud 项目，启用 Gmail API，将应用设为 External 和 In production，创建 Desktop app 客户端，并将其 JSON 保存为 ~/.gmail-mcp/oauth-keys.json。分步指南。

2. 连接账号：

   gmail-mcp-multi auth shop [email protected]
   gmail-mcp-multi auth work [email protected] --calendar
   gmail-mcp-multi add-imap company [email protected] --host mail.example.com   # optional IMAP mailbox
   gmail-mcp-multi default shop
   gmail-mcp-multi doctor
   

3. 添加到 Claude Desktop（Settings → Developer → Edit Config），然后重启 Claude：

   {
     "mcpServers": {
       "gmail-multi": { "command": "npx", "args": ["-y", "multi-gmail-account-mcp", "--mode", "drafts"] }
     }
   }
   

   Claude Code：claude mcp add gmail-multi -- npx -y multi-gmail-account-mcp --mode drafts

4. 向 Claude 提问：

   • 早间简报。（或 /morning-digest）
   • 我应该回复谁？
   • 在所有账号中查找 10 月的 DHL 发票，并读取总金额。
   • 用希腊语为 Maria 起草一封回复，说明订单将于周四发货。

模式

模式	Claude 可以
readonly	搜索、读取、总结、读取附件
drafts（默认）	以上操作，以及起草、将转发内容保存为草稿、管理标签、标记已读/未读、归档，以及预览后批量归档。绝不会发送任何内容。
full	以上操作，以及发送、移至垃圾箱、取消订阅、管理过滤器和创建日历事件

使用 --mode 选择模式。使用 gmail-mcp-multi limit <alias> readonly 限制单个账号。详情请参阅：安全。

文档

设置	安装、Google Cloud、连接账号、Claude Desktop/Code
日常使用	按任务分类的 Claude 提问示例
账号	别名、默认设置、多账号行为、单账号限制
IMAP 账号	非 Gmail 邮箱（Hetzner、cPanel…）
附件	可读取的内容及限制
日历	如何启用、空闲时间搜索、事件
托管模式	通过 Docker + Caddy 使用 claude.ai 网页版和移动版
安全与隐私	模式、加密、审计日志、提示词注入、本地文件
配置	CLI 命令、环境变量、文件
故障排除	常见错误及解决方法
工具参考	所有工具及参数（自动生成）
开发	架构、测试、发布

致谢

本项目基于 Elle Morrill 的 dmorrill/gmail-mcp-multi 分支开发。此分支合并了上游社区提交的拉取请求：

• Dave Moudy： 安全凭据文件、安装文档（#15）
• Vadim Zaliva： 单账号 OAuth 客户端、独立身份验证、只读开关（#13）
• Bobby Marko： 附件、RFC 2047 主题、标签和过滤器（#9、#10、#11）
• 附件下载（#14）

由 Antonis Papamichail（psdgator）维护。欢迎贡献。请参阅 CONTRIBUTING.md。

采用 MIT 许可证。隐私：PRIVACY.md。