关于 Timbre
Timbre 是连接 Claude 与 macOS Apple Mail 的 MCP 服务,可在本机跨账户搜索邮件,并支持谨慎阅读和归档。它面向希望发送前审核邮件操作、并防范欺骗性邮件内容的用户。
主要功能
- 01搜索邮件正文、发件人和附件名称
- 02读取支持的附件和邮件会话
- 03标记可疑发件人、链接和附件
- 04移除并报告邮件中的隐藏指令
- 05起草、归档和标记邮件,操作可撤销
适用场景
- 01跨邮件账户查找账单并读取 PDF
- 02检查邮件或链接是否具有欺骗性
- 03在 Mail 中准备回复并审核
- 04归档新闻邮件并保留撤销选项
MCP 相关
Timbre 是打包为一键式 Claude Desktop 扩展的 MCP 服务,向 Claude 提供 Apple Mail 搜索、阅读、起草和归档能力。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Timbre
连接 Apple Mail 与 Claude 的工具
即时全文搜索所有邮件账户,安全阅读、起草和归档——搜索在你的 Mac 上进行,而不是在 Google 的服务器上。
Français · English
Timbre 将 Claude 连接到 Mac 上的 Apple Mail。它是一款 MCP 服务,打包为一键安装的 Claude Desktop 扩展,可让 Claude 处理你已在 Mail 中收取的邮件,无论账户来自哪里(iCloud、Gmail、Outlook 和 Exchange、Orange、La Poste、任意 IMAP……)。它直接读取 Mail 存储在磁盘上的数据,因此搜索数十万封邮件(包括正文)只需数十毫秒;当你要求它起草、归档或标记邮件时,它会通过官方脚本接口在 Mail 中执行操作。
它的设计考虑到了 AI 助手读取不可信邮件的实际情况:隐藏指令会被移除并报告,伪造的发件人会被标记,绝不会永久删除任何邮件,也不会未经你允许发送任何内容。
状态: v0.6,已在一个包含六个账户、共 132,000 封邮件的真实邮箱中日常使用。欢迎在 Issues 中反馈。
为什么选择 Timbre
- 一次搜索所有邮件。 iCloud、带标签的 Gmail、Outlook、Orange、La Poste、任意 IMAP:搜索正文和附件名称;在 132,000 封邮件中仅需 20 到 40 毫秒;支持 Gmail 风格的运算符,并按 Mail 显示的名称列出文件夹。
- 不遗漏,不隐藏。 完整读取购物邮件和新闻简报的版式,也会读取附件之后的文本;对你隐藏、却面向 AI 的文本会被移除并报告。
- 识别网络钓鱼。 伪造的发件人、隐瞒真实目的地的链接(包括 Outlook Safe Links 背后的链接)、首次联系的发件人、有风险的附件。
- 读取附件。 PDF、Word、RTF、ODT、文本、CSV、邀请函、联系人名片、转发邮件。
- 安全操作。 草稿会在 Mail 中打开,不会自行发送;归档和移至废纸篓的操作都可以撤销;可以创建文件夹,也能删除空文件夹,即使 Mail 不允许任何应用执行这些操作;Timbre 会明确说明自己做不到什么,而不会假装能做到。
- 私密可信。 搜索在你的 Mac 上进行,而不是在服务器上;只需一个经 Apple 签名和公证、拥有自身权限的应用;无需安装其他内容,也无需重启。
实际使用
用自己的话向 Claude 提问;搜索和阅读由 Timbre 完成:
- “找出 9 月的电费账单,告诉我金额。” Timbre 会在账单到达的账户中找到它,并读取附件 PDF。
- “公证人发给我的关于房屋出售的邮件里说了什么?” 正文和附件名称也会纳入搜索,并能识别重音符号和复数形式(facture 也能找到 factures)。
- “总结我和 Sophie 关于假期的对话。” 读取整个邮件会话,并将每封邮件归纳为它新增的内容。
- “这封自称来自银行的邮件是真的吗?” 检查发件人身份验证、仿冒地址、隐瞒真实目的地的链接和隐藏文本。
- “起草一封回复,说星期四我有空。” 草稿会在 Mail 中打开,供你检查;不会发送任何内容。
- “归档上个月的新闻简报。” 移动操作可以撤销。
- “删除 La Poste 账户中的空文件夹。” 每个文件夹都会先在服务器上检查是否为空;首次操作时,会在 Timbre 窗口中提示输入一次密码。
在 Mac 上搜索,而不是在 Google 的服务器上搜索
Claude 的 Gmail 连接器会通过 Gmail API 将每次搜索发送到 Google 的服务器,而且只能访问 Gmail。Timbre 会搜索保存在 Mac 上的索引。该索引由 Apple Mail 已下载的邮件构建,可同时搜索所有账户。
| Timbre | Gmail 连接器 | |
|---|---|---|
| 搜索在哪里运行 | 在你的 Mac 上 | 在 Google 的服务器上(Gmail API) |
| 账户 | 所有账户:iCloud、Gmail、Outlook 和 Exchange、Orange、La Poste,以及任何 IMAP 账户 | 仅 Gmail |
| Google 会收到什么 | 什么也不会:Mail 照常同步你的邮件 | 每次搜索和每封读取的邮件 |
| 你授予的访问权限 | 仅允许 Timbre 读取这台 Mac 上 Mail 的文件 | 通过 Google 登录访问你的 Google 账户 |
| 搜索 132,000 封邮件所需时间 | 20 到 40 毫秒 | 每次搜索都需要一次网络往返 |
无论哪种情况,Claude 读取的内容都会发送给 Claude,以便为你作答。
也在使用 Gmail 连接器? 无需移除它:对于邮件中的任何内容(包括 Gmail),Timbre 都会要求 Claude 先使用 Timbre。对于 Timbre 不支持的操作,例如归档 Gmail 邮件或将其归入标签(脚本无法让 Mail 执行此操作),或者在 Timbre 中关闭发送功能时从 Gmail 发送邮件,你仍可保留 Gmail 连接器。如果 Claude 还是去使用 Gmail,只要告诉它“用 Timbre 搜索”即可。
功能
- 搜索所有内容。 对主题、联系人、邮件正文和附件名称进行全文搜索,并根据相关性、时间新近程度以及你是否与发件人有过往来进行排序。即使 Gmail 将一封邮件归入多个标签,也只会为每封邮件显示一条结果。搜索不区分重音符号和连字(
réunion=reunion,cœur=coeur),支持筛选条件和 Gmail 风格的运算符:from:、to:、cc:、subject:、in:、label:、is:unread、is:flagged、has:attachment、filename:、after:、before:、newer_than:7d、older_than:1y、"exact phrase"(运算符后也可使用,例如from:"Jean Dupont")、prefix*(至少 3 个字母)、-exclude(也支持-from:、-"a phrase")、OR。默认不包括垃圾邮件和废纸篓中的邮件;如果提出要求,仍可搜索其中的文字。 - 安全地阅读。 显示 Mail 中用户实际看到的文字:移除隐藏的 HTML 内容,同时保留所有可见内容(商家的 MJML 布局、放在邮件内附件之后的文字、图片邮件的文本版本),并提示发件人身份真实性、欺骗性链接和高风险附件(程序、宏、网页)等问题。
- 查看对话。 显示完整对话串,并将每封邮件精简为新增内容。
- 阅读附件。 支持 PDF、Word、RTF 和 ODT(由 macOS 在独立进程中转换)、文本、HTML、CSV、日历、联系人卡片和邮件附件。
- 执行可撤销的操作。 草稿(新建、回复、回复所有人、转发)会在 Mail 中打开,供你审核;还可标记为已读/未读、加旗标;移动到归档、废纸篓或任意邮箱,并支持撤销。如果账户没有归档邮箱,系统会像 Mail 的 Archive 按钮那样为其创建一个。Gmail 是个例外:Mail 只允许脚本将 Gmail 邮件移到废纸篓或垃圾邮件中,Timbre 会如实说明,而不会假装可以执行其他操作。
- 创建和删除邮箱。 可以创建文件夹和 Gmail 标签,也可以删除空邮箱;即使 Mail 不允许任何应用执行这些操作也一样:此时 Timbre 会直接操作邮件服务器本身,并且只需输入一次密码(了解如何操作以及原因)。
- 仅在你允许时发送。 默认关闭。启用后,每封邮件都需要经过两个明确步骤;还可设置收件人允许名单和每小时发送上限。
对比情况
Timbre 汇集了开源 Apple Mail 连接器的优秀设计,并增加了其他连接器未能兼顾的功能。以下信息来自各项目的文档或代码(2026 年 11 月);“—”表示项目未对此作说明。
| Timbre | sweetrb | patrickfreyer | imdinu | apple-mail-fast-mcp | falconbradley | |
|---|---|---|---|---|---|---|
| 运行方式 | 原生应用(Rust),已签名并公证 | Node.js 20+ | Python | Python 3.11+ | Python 3.10+ | Python 3.11+ (uv) |
| 读取邮件的方式 | Mail 的数据库和文件 | AppleScript(可选 IMAP) | AppleScript | Mail 的数据库和文件 | AppleScript(可选 IMAP) | Mail 的数据库和文件 |
| 搜索邮件正文 | ✅ 排序索引,新邮件可在数秒内检索 | AppleScript(根据其文档,在大型邮箱中速度较慢),或设置后使用 IMAP | AppleScript | ✅ 索引由命令构建,并通过 --watch 保持最新 | AppleScript,或设置后使用 IMAP | 主题和发件人 |
| 隐藏文本和注入的指令 | 移除、报告并隔离 | — | — | — | — | — |
| 发件人和链接检查 | SPF/DKIM/DMARC、伪装链接、首次联系 | — | — | — | — | — |
| 附件文本(PDF、Word 等) | ✅ | 保存到磁盘 | 保存到磁盘 | ✅ | ✅ | 原始内容 |
| 草稿、回复、转发 | ✅ | ✅ | ✅ | ❌ 只读 | ✅ | ✅ |
| 移动、归档、移至废纸篓 | ✅ 可撤销 | ✅ | ✅ | ❌ | ✅ | ❌ |
| 创建或删除邮箱 | ✅ 在服务器上操作;首次需要时会在窗口中询问一次密码;仅限空邮箱 | ✅ 通过 IMAP 操作;密码需事先在 Terminal 中保存;删除邮箱及其内容 | — | ❌ | ✅ 通过 IMAP 删除;密码需事先用设置命令保存;仅在明确要求时删除非空邮箱 | ❌ |
| 发送邮件 | 默认关闭,分两步操作 | 默认开启 | 默认开启 | — | 需确认 | 无 |
| 持有的 macOS 权限 | Timbre 自己的应用 | Node.js | Python | Terminal 和启动它的应用 | Python | uv 启动器 |
| 许可证 | MIT | MIT | MIT | GPL-3.0 | MIT | MIT |
据我们所知,Timbre 是唯一一款集成了邮件正文排序全文索引、隐藏指令防护、发件人和链接检查、撤销功能、无需预先设置的邮箱管理,以及持有自身权限的已签名并公证应用的 Apple Mail 连接器。sweetrb 提供了更多用于操作 Mail 本身的工具(规则、智能邮箱、模板);Timbre 则专注于助手安全查找、阅读和归档邮件所需的功能。
Timbre 新功能
- 每个账户,包括标签。 Gmail 会在“所有邮件”中为每封邮件只保留一份:Timbre 会读取邮件标签,因此 Gmail 的收件箱、已发送邮件和你的标签都能像任何邮箱一样使用。Orange、Wanadoo 和 La Poste 的已发送邮件(OUTBOX)及垃圾邮件(QUARANTAINE)也能识别。
- 合理排序。 模糊搜索(发票)会优先显示近期邮件;与你经常通信的联系人发来的邮件排名更高;你发给自己的邮件则不会。
- 无需重启。 授予“完全磁盘访问权限”后,Timbre 会在几秒内检测到并开始工作,期间仍可继续使用同一对话。新版本发布时也会通知你。
- 移除隐藏文本。
display:none、零尺寸字体、白底白字、屏幕外文本、裁剪文本、缩小文本、模糊文本和透明文本、被筛选或混合效果隐藏的文本,以及零宽和双向文本字符,都会从 Claude 读取的内容中移除;同时还会统计这些内容,并扫描其中是否包含针对 AI 的指令。样式表会由 Firefox 使用的 CSS 解析器和选择器引擎读取,并根据 Mail 在 Mac 上的渲染方式进行判断,其中包括级联层、嵌套规则、@container、@scope、::first-line、动画和影子树。如果邮件的显示内容取决于 Mail 窗口的宽度,则只保留在任何宽度下都可见的内容。 - 你看到的,就是 Claude 读取的内容。 Timbre 会读取 Mail 显示的 HTML 部分,而不是攻击者可以填入不同内容的 text/plain 替代内容(两者不一致时会发出警告)。
- 发件人检查。 SPF/DKIM/DMARC 结果、显示名称所示地址与实际地址不一致、回复地址属于其他域、punycode 域名、链接文本显示的域名与实际指向的域名不一致,以及首次联系(此前从未与你通信过的发件人)。
- 醒目标记。 每封不可信邮件正文都会用发件人无法预测的随机标记括起来。
- 附件。 可执行文件、双重扩展名(
invoice.pdf.app)和宏文件都会被标记;保存的文件会放入你选择的同一个文件夹,不会覆盖现有文件,并会标记为供 Gatekeeper 检查。 - 最小权限。 读取工具会标记为只读,Claude 可直接使用,无需询问;会更改内容的工具也会明确标记;只有在你启用发送工具后,这类工具才会出现。
- 只为 Timbre 授予一项权限。 “完全磁盘访问权限”授予的是 Timbre 自己的签名应用,它有自己的名称和图标,而不是授予 Claude 或与其他扩展共用的启动器:Timbre 会向 macOS 表明,它代表自身请求访问权限。
创建和删除邮箱
Mail 不允许任何脚本删除邮箱,而在当前版本的 macOS 上,它也拒绝创建邮箱,La Poste 就是如此:它的脚本接口会返回“AppleEvent handler failed”(sweetrb 测试发现,各类账户都一样)。因此,Timbre 会像 Mail 自己的“邮箱”菜单那样操作:通过 IMAP 直接操作邮件服务器,然后让 Mail 同步更新。它仍会先请求 Mail 创建邮箱,以防 Mail 能成功:这样就不需要密码。
- 每个账户只需操作一次。 安装时无需操作。第一次让 Claude 在 Mail 无法处理的账户中创建或删除文件夹时,Timbre 会弹出窗口,请求该账户的密码,并用一句话说明原因。服务器会验证密码;随后密码会保存在你的登录钥匙串中,只有 Timbre 的已签名应用可以读取,而且之后不再询问。Claude 永远不会看到密码。Google、Apple 和 Yahoo 在这里仅接受应用专用密码:窗口中的按钮会打开创建应用专用密码的页面。
- Timbre 的检查。 只有当服务器确认邮箱中没有邮件或其他邮箱,并且服务器和 Mail 都没有将其保留自用时,才会删除邮箱(收件箱、已发送邮件、草稿、废纸篓、垃圾邮件、待发送邮件、Apple Notes、Gmail 自己的文件夹,以及服务器标记为自用的任何文件夹都属于保留范围)。空的归档邮箱可以删除:Mail 下次归档时会重新创建。删除邮箱时绝不会连带删除邮件:请先移动邮件,这一步可以撤销。连接经过加密,其证书由 macOS 检查,方式与 Mail 检查证书相同。
- Mail 同步更新。 在我们的测试中,在服务器上创建的邮箱会在几秒内显示在 Mail 中。删除的邮箱会继续留在 Mail 的侧边栏中,直到下次打开 Mail;届时 Mail 会自动将其移除:无需额外操作,退出并重新打开 Mail 后,它会立即消失。Timbre 会说明发生了什么。
- 无法处理的情况。 Exchange 和 Outlook.com 账户(Microsoft 只接受自己的登录方式,而 Mail 会将其保密)、POP 账户以及“在我的 Mac 上”邮箱(仅由 Mail 保管):这些情况下,请使用 Mail 的“邮箱”菜单。
还考虑过另外三种方式,但最终没有采用:
- Mail 关闭时编辑其数据库。 数据库只是 Mail 对服务器内容的副本:在数据库中删除的邮箱会在 Mail 下次检查时重新出现。
- 重复使用 Mail 保存的密码,并通过 Mac 密码解锁。 当前版本的 macOS 会将这些密码保存在钥匙串的受保护区域(“本地项目”)中,只有 Apple 自己的应用可以打开:没有任何窗口能让其他应用访问。Timbre 仍会查找 macOS 早期版本保存这些密码的位置,即登录钥匙串;macOS 会先要求输入 Mac 密码,然后才允许读取密码。
- 操作 Mail 的菜单。 这需要“辅助功能”权限,也就是控制整台 Mac 的权限;而且 Mail 一旦更改菜单或使用另一种语言,这种方式就会失效。
sweetrb 和 apple-mail-fast-mcp 也通过 IMAP 操作,但需要你提前创建并自行保存密码,操作方式是在 Terminal 中完成,或使用设置命令。两者都会使用 macOS 的 security 工具保存密码;之后,该工具会将密码提供给任何运行同一工具的程序,而不会再次询问。sweetrb 会连同邮箱中的所有内容一起删除;apple-mail-fast-mcp 会拒绝删除非空邮箱,除非你同时要求它删除其中的邮件;Timbre 则绝不会在删除邮箱时删除邮件。
已签名并经过公证
每个版本都使用作者的 Developer ID(Alejandro San Martin Lamas,团队 4FQA525DB9)签名,并经过 Apple 公证。这意味着:
- 它来自作者,且未被篡改。 Timbre 启动时,macOS 会检查签名;任何人修改过的副本都无法通过检查。
- 经过 Apple 检查。 发布前,Apple 的公证服务会扫描其中是否含有已知恶意内容。macOS 打开它时不会显示未识别开发者警告;如果日后发现问题,Apple 可以撤销公证。
- 更新后,权限仍然有效。 macOS 将“完全磁盘访问权限”与 Timbre 的签名绑定,而不是与某个特定文件绑定:新版本仍可使用该权限。
- 它不代表什么。 公证是自动扫描,并非对程序功能的审核。要了解这一点,可以查看 Timbre 的开源代码。
如需自行检查:
APP="$HOME/Library/Application Support/Claude/Claude Extensions/local.mcpb.alejandro-san-martin-lamas.timbre/server/Timbre.app"
codesign -dv --verbose=2 "$APP" 2>&1 | grep Authority # Developer ID Application: Alejandro San Martin Lamas (4FQA525DB9)
spctl --assess -vv "$APP" # accepted, source=Notarized Developer ID
性能
在一台小型双核虚拟机上,为包含 20,000 封邮件的合成邮箱(788 MB:HTML 新闻邮件、带引用历史的回复、附件、法语、英语和西班牙语文本,词汇分布贴近实际情况)建立索引:
| v0.1.0 | v0.4.0 | v0.5.7 | |
|---|---|---|---|
| 完整索引构建 | 28.6 s | 13.0 s | 17.0 s |
| 索引磁盘占用 | 298 MB | 124 MB | 126 MB |
| 搜索,中位数 | 42 ms | 18 ms | 28 ms |
| 搜索,第 95 百分位 | 62 ms | 30 ms | 45 ms |
0.5.7 稍慢一些,是因为结果更准确:它会读取每封邮件的所有部分,并按照 Mail 的 WebKit 显示方式判断哪些文本可见;垃圾邮件和废纸篓邮件也会编入索引(但搜索仍会将它们排除);对于宽泛查询,它会按日期而非 Mail 存储邮件的顺序,对最新匹配项进行排序,因此后来添加的账户中的邮件不会挤掉本月的邮件。
性能提升的原因:在所有核心上解析邮件,同时由单个写入器提交大型事务;延后 FTS5 的合并,并使用 64 MiB 的待处理词项表;用于摘要的文本仅存储一次,并使用 zstd 压缩;不建立前缀索引;仅为返回的页面计算摘要和详细信息;对于非常宽泛的查询,只对最新的 10,000 个匹配项进行排序。跳过那些只在读取邮件时才有用的索引构建工作。如需复现:运行 timbre dev-corpus /tmp/corpus 20000(调试构建),然后在发布构建中运行 timbre index --rebuild 和 timbre bench,并将 TIMBRE_MAIL_ROOT、TIMBRE_ACCOUNTS_DB 和 TIMBRE_DATA_DIR 指向该目录。
0.6.5 也能创建和删除邮箱,其速度与 0.5.7 一样快;在同一台机器上并排测量时,索引构建需要 15 到 16 s,大小保持不变;搜索响应时间为 25 到 26 ms(中位数)和 43 到 45 ms(第 95 百分位)。Claude 在每次对话中读取的 Timbre 工具说明缩短了 1,600 个字符。
在真实 Mac 上(Apple 芯片,六个账户共 132,000 封邮件,包含 Gmail),索引约占 500 MB,搜索响应时间为 20 到 40 ms。
安装
- 从 Releases 下载
timbre-<version>.mcpb并双击;Claude Desktop 会安装它。发行版本已使用 Developer ID 签名,并经过 Apple 公证。 - 为 Timbre 授予完全磁盘访问权限。让 Claude 打开 Timbre 的权限设置:系统设置会打开“隐私与安全性 › 完全磁盘访问权限”,Finder 会选中 Timbre(印章图标)。将它拖入列表并开启开关。几秒钟后 Timbre 就会自动开始工作:无需重启任何内容。
- 首次让 Timbre 起草邮件或移动邮件时,macOS 会询问是否允许 Timbre 控制 Mail:点击“好”。
安装时不会询问其他信息。只有当你首次在 Mail 不会创建文件夹的账户中创建或删除文件夹时,才会要求输入密码,而且只询问一次。
首次启动时,全文索引会在后台建立(在较新的 Mac 上,每 100,000 封邮件约需一分钟);与此同时,你仍可按主题和发件人搜索。之后,新邮件会在几秒内即可搜索。更新后,如果 Timbre 能更好地读取邮件,它会在后台重新读取邮件,从最新邮件开始,同时搜索仍可正常使用。
工具
| 工具 | 功能 | 会更改内容吗? |
|---|---|---|
search_mail | 使用筛选条件进行全文搜索 | 否 |
read_mail | 读取单封邮件,包含警告和附件 | 否 |
get_thread | 读取整个邮件对话 | 否 |
list_mailboxes | 列出账户和邮箱及其邮件数量 | 否 |
read_attachment | 读取附件文本:PDF、Word、RTF、ODT、文本、HTML、CSV、日历、邮件附件 | 否 |
mail_status | 查看权限、索引进度、设置和较新版本 | 否 |
open_permission_settings | 打开“完全磁盘访问权限”(或“自动化”)设置并显示 Timbre | 打开“系统设置” |
selected_mail | 查看 Mail 中选中的邮件 | 否 |
open_in_mail | 在 Mail 中打开邮件 | 否 |
save_attachment | 将附件保存到你的附件文件夹 | 添加一个文件 |
create_draft | 新建、回复、回复所有人、转发——均保存为草稿 | 添加一封草稿 |
mark_mail | 标记为已读/未读、加旗标/取消旗标 | 是 |
move_mail / undo_move | 归档、移至废纸篓、移至任意邮箱——并可移回(Gmail:移至废纸篓或垃圾邮件) | 是,可撤销 |
create_mailbox | 创建邮箱或 Gmail 标签:由 Mail 创建,或在服务器上创建 | 添加一个邮箱 |
delete_mailbox | 在服务器上删除空邮箱或 Gmail 标签 | 是,仅限空邮箱 |
prepare_send / confirm_send | 分两步发送(仅在启用后) | 发送邮件 |
常见问题
如何将 Claude 连接到 Apple Mail? 在 Claude Desktop 中安装 Timbre(从 Releases 下载 .mcpb 并打开),在 Claude 询问时授予它完全磁盘访问权限,然后用你自己的话向 Claude 询问邮件相关问题。
哪些账户可以使用? Apple Mail 中设置的所有账户:iCloud、Gmail 和 Google Workspace(包括标签)、Outlook 和 Exchange、Yahoo、Orange、Free、SFR、La Poste,以及任何 IMAP 或 POP 账户,还有“在我的 Mac 上”邮箱。
我的邮件会离开 Mac 吗? 搜索和索引都留在你的 Mac 上。只有 Claude 为了回答你而读取的内容会发送给 Claude。Timbre 本身不会收集任何内容。
Claude 能发送邮件或删除我的邮件吗? 在你开启发送功能之前,发送处于关闭状态;开启后,每封邮件都必须经过明确的两步操作。邮件绝不会被永久删除:移至废纸篓的操作可以撤销,而且只会删除空邮箱。
它能防范网络钓鱼和提示词注入吗? 对你隐藏、但针对 AI 的文本会被移除并报告;每封邮件都会被标记为不可信内容,伪造的发件人和欺诈链接也会被标记。
它需要 Gmail 连接器吗?没有 Claude Desktop 也能使用吗? 不需要连接器:Timbre 会通过 Mail 读取所有账户。它适用于 macOS 12 或更高版本上的 Claude Desktop;Mac 上的其他 MCP 客户端也可以运行它的程序。
设置
在 Claude › 设置 › 扩展 › Timbre 中:只读模式、允许发送、允许的收件人([email protected], @mycompany.com)、每小时最大发送数量、搜索时排除的邮箱(默认为垃圾邮件和废纸篓;留空可搜索所有内容,也可以按需填写角色:spam、corbeille、archive……)、附件文件夹,以及每日更新检查。
隐私
完整政策见 PRIVACY.md。搜索、读取和索引都保留在你的 Mac 上:Timbre 不会将任何邮件信息发送到任何地方,也不会收集任何信息。它仅会在两种情况下连接网络:每日检查 GitHub 上的最新版本号(关闭 检查更新 即可停止),以及在你创建或删除 Mail 无法处理的邮箱时,通过加密连接访问你自己的邮件服务器。该服务器的密码保存在你的登录钥匙串中,名称为 Timbre IMAP (server);在钥匙串中删除它,Timbre 就会忘记该密码。Claude 读取的内容会发送给 Claude,以便为你作答。索引(~/Library/Application Support/Timbre)包含用于搜索的邮件文本;删除该文件夹即可将其移除。Mail 自带的数据库始终以只读方式打开。
从源代码构建
cargo test # unit and end-to-end tests on a synthetic mail store
cargo build --release # on macOS
scripts/build-macos-from-linux.sh # cross-compile from Linux (cargo-zigbuild)
scripts/package-mcpb.sh # assemble the Claude Desktop extension
timbre index | timbre search "facture from:orange" | timbre doctor | timbre bench
Star 历史
致谢
由 Alejandro San Martin Lamas 创建 — github.com/alejandrosml。
Timbre 站在前人的成果之上,在此致谢:由 falconbradley/claude-connector-apple-mail 记录的 Envelope Index 读取路径和 flags 位域,sweetrb/apple-mail-mcp 的 Mail 脚本模式,imdinu/apple-mail-mcp 的 FTS5 正文索引思路,以及 apple-mail-fast-mcp 的确认门控。Timbre 的代码为原创,使用 Rust 编写。
许可证
MIT © 2026 Alejandro San Martin Lamas
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。