Mail MCP Bridge

邮件MCP网桥

通过模型上下文协议（MCP）将macOS Mail连接到AI

邮件MCP网桥 使AI助手（如Claude、ChatGPT）能够直接访问和分析您的macOS Mail电子邮件。只需从Mail复制一个邮件ID并将其粘贴到AI上，就不需要手动导出电子邮件。

演示：亲眼目睹 （点击观看）

*显示：从邮件中复制邮件ID→ AI分析电子邮件内容*

🇨🇳 中文版

🎯 什么和为什么

问题：现实世界中的大部分沟通都是通过电子邮件进行的——项目合作、客户沟通、商业谈判、技术支持。手动导出电子邮件进行人工智能分析既繁琐又低效。

解决方案：Mail MCP Bridge让AI通过简单的工作流程直接读取您的电子邮件：

• 从邮件复制邮件ID（一个键盘快捷键）
• 粘贴到AI
• AI即时分析电子邮件内容

用例:

• 📋 通过电子邮件跟踪项目进度
• 💼 从业务通信中提取关键信息
• 🔍 总结长电子邮件对话
• 📊 提取结构化数据（需求、反馈、承诺）
• 🤝 查看对话历史记录
• 📎 分析电子邮件附件（发票、报告、文档）

✨ 特性

• 📧 直接访问 -AI通过MCP协议读取您的电子邮件
• 🧵 线程支持 -使用一个消息ID检索整个对话
• 📎 附件提取 -提取电子邮件附件以进行人工智能分析（PDF、文档、图像）
• 🎨 Claude代码插件 -用于智能电子邮件分析的预构建命令和技能
• ⚡ 快速 -毫秒级查询响应
• 🎯 清洁文本 -针对AI优化的文本提取（不包括HTML、嵌入式图像）
• 🔒 隐私第一 -在本地运行，电子邮件永远不会离开你的Mac

🚀 快速开始

先决条件

• macOS 12.0+（带邮件应用程序）
• Python 3.9+
• MCP兼容的人工智能助手（例如Claude Desktop）

安装

# Clone the repository
git clone https://github.com/fatbobman/mail-mcp-bridge.git
cd mail-mcp-bridge

# Install MCP dependencies
pip3 install mcp

配置Claude桌面

1. 查找配置位置:

   ~/Library/Application Support/Claude/claude_desktop_config.json

1. 编辑配置 （如果不存在则创建）：

   {
     "mcpServers": {
       "mail": {
         "command": "python3",
         "args": [
           "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
         ]
       }
     }
   }

重要：替换 /path/to/mail-mcp-bridge 根据您的实际项目路径。

可选的：配置附件临时目录（默认为 /tmp/mail-mcp-attachments):

   {
     "mcpServers": {
       "mail": {
         "command": "python3",
         "args": [
           "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
         ],
         "env": {
           "MAIL_ATTACHMENT_PATH": "/tmp"
         }
       }
     }
   }

1. 重新启动克劳德桌面 （完全退出，然后重新打开）

安装Claude代码插件（可选但推荐）

邮件MCP包括即用型 Claude代码插件 提供智能电子邮件分析功能：

你得到了什么:

• 🎯 智能附件分析 -自动检测重要附件（发票、合同、税务文件）
• 🧵 线程跟踪 -跟踪电子邮件对话中的文档演变
• 🚀 3种分析模式 -快速/交互式/自动模式，优化代币使用
• 📋 动作项提取 -在电子邮件中查找截止日期和任务

安装:

# 1. Add the Mail MCP plugin marketplace
/plugin marketplace add /path/to/mail-mcp-bridge/plugins

# 2. Install the attachment analyzer
/plugin install mail-attachment-analyzer@mail-mcp

# 3. Restart Claude Code

替换 /path/to/mail-mcp-bridge 使用您的实际安装路径。

用法:

安装后，插件会自动工作：

You: Analyze this email 
AI: [Automatically detects attachments and analyzes intelligently]

或使用手动命令：

/mail-mcp:analyze-attachment

📖 → 插件文档

设置邮件快速操作

在邮件应用程序中添加“复制邮件ID”按钮：

步进:

1. 打开 自动操作 (⌘ + Space，类型“自动机”）

1. 创建新的 快速操作:

- File → New (⌘ + N) - 选择“快速操作” - 工作流接收当前： 没有输入 - 在： 邮件.app

1. 添加 运行Shell脚本 动作：

- 在左侧面板中搜索“运行Shell脚本” - 拖动到工作流区域 - 外壳：\`/bin/bash\*\*

1. 复制脚本内容：

   cat automator_script.sh

将整个输出粘贴到Automator脚本区域

1. 另存为 “复制邮件ID”

1. （可选）指定键盘快捷键：

- 系统设置→ 键盘→ 键盘快捷键 - 服务→ Mail → “复制邮件ID” - 添加快捷方式（例如。， ⌘ + ⇧ + C)

自动机设置示例:

Automator setup example

测试IT:

1. 打开邮件应用程序
2. 选择任何电子邮件
3. 按键盘快捷键（如果已配置）
4. 您应该听到一个声音，确认邮件ID已复制

📖 用法

基本工作流程

1. Select email in Mail
2. Press your keyboard shortcut (e.g., ⌘⇧C)
3. Paste Message-ID to AI

对话示例

阅读单个电子邮件:

You: Please analyze this email: 

AI: I'll read that email for you...
[AI reads and analyzes the email content]

阅读电子邮件主题:

You: What's the full conversation for ?

AI: I'll retrieve the entire thread...
[AI shows all emails in the conversation]

真实世界用例:

You: Please summarize all communication with our business partner,
including their requirements, promised timelines, and action items.

AI: I'll read the relevant email threads and extract key information...
[AI analyzes email content, organizes project progress, commitments, and action items]

提取电子邮件附件:

You: Extract and analyze the PDF invoice from this email: 

AI: I can see this email has an invoice.pdf attachment (1.2MB). Let me extract it...
[AI extracts attachment and analyzes the content]

🛠️ MCP工具

📖 → API详细文档

🏗️ 运作原理

┌─────────────┐
│  Mail App   │ Select email → Copy Message-ID (⌘⇧C)
└──────┬──────┘
       │
       ↓ Message-ID
┌─────────────┐
│MCP Server   │ 1. Query Mail SQLite database
│             │ 2. Locate .emlx file by ROWID
│             │ 3. Parse email content
│             │ 4. Extract plain text
└──────┬──────┘
       │
       ↓ Structured Data
┌─────────────┐
│ AI Assistant│ Analyze email content
└─────────────┘

🔧 → 技术架构

🐛 故障排除

未找到MCP服务器

解决方案:

# Verify the path in claude_desktop_config.json
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Restart Claude Desktop (quit completely, then reopen)

未找到电子邮件

可能的原因:

1. 消息ID格式不正确（必须包括 ``)
2. 已从邮件中删除电子邮件
3. 不同邮件帐户数据库中的电子邮件

权限不足

解决方案:

# Make scripts executable
chmod +x *.py *.sh

🔒 隐私和安全

• ✅ 本地处理：所有操作都在Mac上本地运行
• ✅ 无外部服务器：没有数据发送到外部服务器
• ✅ 无遥测：无分析或跟踪
• ✅ 只读的：只读取电子邮件数据，从不修改

📚 文档

• TOOLS.md -所有MCP工具的完整API参考资料
• 建筑.md -技术架构和数据库结构
• README_zh.md - 中文文档

📝 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

欢迎投稿！请随时提交拉取请求。

🌟 致谢

• 为MCP（模型上下文协议）生态系统构建
• 受到连接电子邮件和人工智能需求的启发
• 在macOS 26（Tahoe）上使用Claude Desktop进行测试

📮 联系

• 问题:
• 作者：胖子（徐阳）

☕ 给我买杯咖啡

如果你觉得这个项目有帮助，可以考虑给我买杯咖啡！


______________________________________________________________________

由以下材料制成❤️ 对于AI社区