MCP

MailFathom:把 IMAP 邮箱同步进自有 PostgreSQL 的 MCP 检索服务

MailFathom 最适合让 AI 在你自己运行的 PostgreSQL 邮件副本上检索邮件、取全文并回答邮件相关问题;使用前要知道:邮箱以 IMAP 方式同步进自托管数据库,而标记、起草、发送等写操作默认关闭,必须按账号、按凭证单独授权后才会开启。

官方来源 · MailFathom

安装

git clone https://github.com/fathomise/MailFathom.git
cd MailFathom
scripts/quick-start-compose.sh

适合谁

MailFathom 把多个 IMAP 邮箱同步进一个由你自己运行的 PostgreSQL 数据库,对这份副本建索引,再以 MCP(Model Context Protocol)工具交给 AI 使用。它适合:

  • 想让 AI 帮自己查邮件、回答邮件相关问题,而不想在网页邮箱里反复搜索的人;
  • 已有自托管条件、愿意自己运行数据库与服务进程的个人或小团队;
  • 在意数据边界,希望邮件副本与索引只落在自己机器上的用户;
  • 手里有多个 IMAP 邮箱、想让 AI 在同一处一起检索的人:多个账号同步进同一个数据库。

使用前提与不适合的情况:

  • 它不是托管服务:PostgreSQL 和 MailFathom 本身都要你自己运行与维护,不想管服务器的人不适合;
  • 证据只说明了 IMAP 邮箱同步,是否支持其他邮件协议、日历或附件深度解析均未说明,未确认;
  • 标记、起草、发送这类写操作默认全部关闭,每个账号、每个凭证都要单独授权后才会开启,期待开箱即写的人要先接受这套授权流程。

3 分钟完成第一次尝试

推荐主路径只有一条:克隆官方仓库并运行快速上手脚本。

git clone https://github.com/fathomise/MailFathom.git
cd MailFathom
scripts/quick-start-compose.sh

前提:一台你可控的机器,并接受邮件副本会存进你运行的 PostgreSQL。脚本所需端口、环境变量等细节证据未写明,执行前先读脚本确认。之后把服务作为 MCP 接入你的 AI 客户端,接入配置证据未给出,以仓库说明为准。

第一次调用建议用 list_accounts:属于读取类工具,不涉及标记、起草、发送这些写动作;成功信号是 AI 返回已同步账号的列表。想再进一步,可调用 search_emails 按关键词搜邮件,结果按词法排序;配置嵌入模型后,排序还会参考语义相似度。

读取查的都是同步进数据库的副本;多久同步一轮、与真实收件箱时差多大,证据未说明,未确认。

注意:只读不等于零风险——读取工具能看到你同步进数据库的全部邮件;哪些邮箱进入副本、同步范围如何控制,证据未说明,未确认。

使用案例

案例一:按关键词找回旧邮件。场景:记得某封邮件提过某个词,又不想逐页翻收件箱。做法:让 AI 调用 search_emails,给出关键词。可期待的结果:按词法排序(配置嵌入模型后含语义相似度)的匹配邮件列表;需要全文时再用 get_email_content,一次最多取十封完整内容。

案例二:跨多封邮件提问。场景:这单事情前后都说了什么,这类需要综合多封邮件的问题。做法:调用 ask_mail,用一句自然语言提问。可期待的结果:它基于你同步的邮件回答,并逐条标注引用了哪些邮件;覆盖范围取决于已同步进数据库的邮件。

两个案例都只用读取能力。要标记、起草或发送,必须先按账号、按凭证单独开启对应写权限——这是官方设计,不是故障。

使用边界

  • 读写性质:读取类工具(list_accounts、list_emails、search_emails、get_email_content、ask_mail)与写操作(标记、起草、发送)严格分开;写能力默认关闭,须按账号、按凭证逐一授权后开启。写操作作用于真实邮箱还是本地同步副本,官方未说明,未确认;是否提供撤销路径,同样未确认。
  • 凭证与数据:同步的对象是你的 IMAP 邮箱,副本与索引都存在你自己的 PostgreSQL 里;IMAP 凭证如何提交、如何存储、是否加密,证据未说明,未确认。
  • 检索与回答的质量边界:search_emails 默认按词法排序,语义相似度要配置嵌入模型后才生效;ask_mail 的回答和引用都建立在已同步邮件之上,问不到没同步进来的内容。
  • 副作用与确认点:开启每一项写授权都是应当想清楚的确认点——只开确实需要的那一项;写操作的具体效果证据未说明,首次尝试建议不开写授权,只用读取工具。
  • 工具范围:官方说明二十一个工具就是全部表面;此外的能力没有证据支持,不要按"应该也行"预期。
  • 尚未确认的关键信息:写操作的作用位置、IMAP 凭证的存储方式、除快速上手脚本外的其他安装方式、具体配置项与性能上限、同步频率,证据均未覆盖;许可证类型为 AGPL-3.0-only(来源标题标注),全文未收录,请以官方仓库为准。