Mail MCP Bridge

MCP办公协作

提供方 fatbobman

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude

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

一句话选型结论

按资料字段整理

Mail MCP Bridge 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 14 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

邮件分析Python本地部署AI集成macOS工具自动化处理隐私保护

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mail MCP Bridge当前 未标注 stdio · 本地进程 本地部署 无 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方fatbobman上游标注的维护方 fatbobman
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.3 KB
来自项目仓库与上游目录的原文,未做删改

邮件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)

安装```bash

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. **查找配置位置**:```bash
~/Library/Application Support/Claude/claude_desktop_config.json
  1. 编辑配置 (如果不存在则创建):```json
    {
    "mcpServers": {
    "mail": {
    "command": "python3",
    "args": [
    "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
    ]
    }
    }
    }

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

**可选的**:配置附件临时目录(默认为 `/tmp/mail-mcp-attachments`):```json
{
"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种分析模式 -快速/交互式/自动模式,优化代币使用
  • 📋 动作项提取 -在电子邮件中查找截止日期和任务

安装:```bash

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. 复制脚本内容:```bash
cat automator_script.sh

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

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

  2. (可选)指定键盘快捷键:

  • 系统设置→ 键盘→ 键盘快捷键
  • 服务→ 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:

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]

提取电子邮件附件:```text
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工具

|工具|说明|
|------|-------------|
| `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服务器

解决方案:```bash

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格式不正确(必须包括 `< >`)
1. 已从邮件中删除电子邮件
1. 不同邮件帐户数据库中的电子邮件

### 权限不足

**解决方案**:```bash
# Make scripts executable
chmod +x *.py *.sh

🔒 隐私和安全

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

📚 文档

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

📝 许可证

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

🤝 贡献

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

🌟 致谢

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

📮 联系

  • 问题:
  • 作者:胖子(徐阳)

☕ 给我买杯咖啡

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


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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mail MCP Bridge 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Mail MCP Bridge 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mail MCP Bridge 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mail MCP Bridge 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Mail MCP Bridge 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mail MCP Bridge 能提供哪些能力?

资料显示能力标签包括 隐私保护、Python、Claude、自动化处理。具体工具清单以官方文档为准。

Mail MCP Bridge 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Mail MCP Bridge 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。