mcpField
T
Timbre

Timbre

本地服务
github.com通信协作11 天前更新

关于 Timbre

Timbre 是连接 Claude 与 macOS Apple Mail 的 MCP 服务,可在本机跨账户搜索邮件,并支持谨慎阅读和归档。它面向希望发送前审核邮件操作、并防范欺骗性邮件内容的用户。

主要功能

  1. 01搜索邮件正文、发件人和附件名称
  2. 02读取支持的附件和邮件会话
  3. 03标记可疑发件人、链接和附件
  4. 04移除并报告邮件中的隐藏指令
  5. 05起草、归档和标记邮件,操作可撤销

适用场景

  1. 01跨邮件账户查找账单并读取 PDF
  2. 02检查邮件或链接是否具有欺骗性
  3. 03在 Mail 中准备回复并审核
  4. 04归档新闻邮件并保留撤销选项

MCP 相关

Timbre 是打包为一键式 Claude Desktop 扩展的 MCP 服务,向 Claude 提供 Apple Mail 搜索、阅读、起草和归档能力。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库
安装包
mcpbtimbre-0.6.5.mcpb

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Timbre 图标:一枚带信封的邮票

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 已下载的邮件构建,可同时搜索所有账户。

TimbreGmail 连接器
搜索在哪里运行在你的 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 月);“—”表示项目未对此作说明。

Timbresweetrbpatrickfreyerimdinuapple-mail-fast-mcpfalconbradley
运行方式原生应用(Rust),已签名并公证Node.js 20+PythonPython 3.11+Python 3.10+Python 3.11+ (uv)
读取邮件的方式Mail 的数据库和文件AppleScript(可选 IMAP)AppleScriptMail 的数据库和文件AppleScript(可选 IMAP)Mail 的数据库和文件
搜索邮件正文✅ 排序索引,新邮件可在数秒内检索AppleScript(根据其文档,在大型邮箱中速度较慢),或设置后使用 IMAPAppleScript✅ 索引由命令构建,并通过 --watch 保持最新AppleScript,或设置后使用 IMAP主题和发件人
隐藏文本和注入的指令移除、报告并隔离—————
发件人和链接检查SPF/DKIM/DMARC、伪装链接、首次联系—————
附件文本(PDF、Word 等)✅保存到磁盘保存到磁盘✅✅原始内容
草稿、回复、转发✅✅✅❌ 只读✅✅
移动、归档、移至废纸篓✅ 可撤销✅✅❌✅❌
创建或删除邮箱✅ 在服务器上操作;首次需要时会在窗口中询问一次密码;仅限空邮箱✅ 通过 IMAP 操作;密码需事先在 Terminal 中保存;删除邮箱及其内容—❌✅ 通过 IMAP 删除;密码需事先用设置命令保存;仅在明确要求时删除非空邮箱❌
发送邮件默认关闭,分两步操作默认开启默认开启—需确认无
持有的 macOS 权限Timbre 自己的应用Node.jsPythonTerminal 和启动它的应用Pythonuv 启动器
许可证MITMITMITGPL-3.0MITMIT

据我们所知,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.0v0.4.0v0.5.7
完整索引构建28.6 s13.0 s17.0 s
索引磁盘占用298 MB124 MB126 MB
搜索,中位数42 ms18 ms28 ms
搜索,第 95 百分位62 ms30 ms45 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。

安装

  1. 从 Releases 下载 timbre-<version>.mcpb 并双击;Claude Desktop 会安装它。发行版本已使用 Developer ID 签名,并经过 Apple 公证。
  2. 为 Timbre 授予完全磁盘访问权限。让 Claude 打开 Timbre 的权限设置:系统设置会打开“隐私与安全性 › 完全磁盘访问权限”,Finder 会选中 Timbre(印章图标)。将它拖入列表并开启开关。几秒钟后 Timbre 就会自动开始工作:无需重启任何内容。
  3. 首次让 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 历史

Timbre 的 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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。