AI导哈

邮件AI分析桥接器

Mail MCP Bridge是一款连接macOS Mail与AI助手的工具，通过Model Context Protocol（MCP）协议实现AI对邮件的直接访问和分析，适用于项目跟踪、业务沟通和附件分析等场景。

  • by fatbobman
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 fatbobman/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

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

    {
  "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"
      }
    }
  }
}

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

安装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 <message-id@example.com>
AI: [Automatically detects attachments and analyzes intelligently]

或使用手动命令：

/mail-mcp:analyze-attachment

📖 → 插件文档

设置邮件快速操作

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

步进:

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

  2. 创建新的 快速操作:

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

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

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

  4. 复制脚本内容：

    cat automator_script.sh

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

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

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

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

自动机设置示例:

测试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: <message-id@example.com>

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

阅读电子邮件主题:

You: What's the full conversation for <message-id@example.com>?

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: <message-id@example.com>

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工具

工具 说明
get_email_path 获取单个电子邮件文件路径
get_thread_paths 获取电子邮件线程中的所有路径
read_email 读取单个电子邮件内容（包括附件元数据）
read_thread 阅读整个电子邮件线程
extract_attachments 从电子邮件中提取特定附件
cleanup_attachments 清理临时附件文件

📖 → 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上本地运行
  • ✅ 无外部服务器：没有数据发送到外部服务器
  • ✅ 无遥测：无分析或跟踪
  • ✅ 只读的：只读取电子邮件数据，从不修改

📚 文档

📝 许可证

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

🤝 贡献

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

🌟 致谢

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

📮 联系

☕ 给我买杯咖啡

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

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

相关 MCP