Fastmail MCP Server：让 AI 助手直接操作邮箱与日历

场景引入

凌晨两点，工程师小张在处理一个紧急 bug，需要查阅三天前某位同事发来的邮件来还原上下文。他不想打开邮箱客户端打断思路，只想在一个 AI 对话窗口里直接问："帮我找一下上周三王工发的那封关于部署方案调整的邮件。"——这种体验，Fastmail MCP Server 正在尝试实现。

Fastmail MCP Server 是一个非官方的 Model Context Protocol（MCP）服务器，它将 Fastmail 的 JMAP/CalDAV/WebDAV API 封装为一组标准化的工具（tools），让 AI 助手（如 Claude Desktop）能够直接读取、搜索、发送邮件，以及管理日历和联系人。

注：Fastmail 是一个以隐私保护著称的邮件服务商，采用开放的 JMAP 协议作为其核心 API。本项目为社区作品，与 Fastmail 无官方隶属关系。

项目背景与作者

该项目由独立开发者 Jeremy Gill 创建并维护，仓库创建于 2025 年 6 月，遵循 MIT 开源协议。截至目前已获得 125 颗 Stars、47 个 Forks，在 MCP 相关生态中属于活跃度较高的工具型项目。

项目的诞生背景非常清晰：随着 AI 助手（Claude、ChatGPT 等）逐渐成为程序员日常工作的核心工具，用户希望 AI 能够直接访问自己的邮件、日历数据来完成信息检索、任务规划等操作，而不是让 AI 在一个封闭的沙箱里工作。Fastmail 提供了开放的 JMAP API，但缺乏与主流 AI 助手的原生集成——这个 Gap 正是 fastmail-mcp 要填补的。

技术架构：模块化 MCP 服务器

fastmail-mcp 的整体架构可以概括为"一个主入口 + 多个专业客户端"：

┌──────────────────────────────────────────────────────┐
│                    MCP Server (index.ts)              │
│   Server + StdioServerTransport + MCP SDK           │
├──────────┬──────────┬──────────────┬─────────────────┤
│ JmapClient│Contacts- │ CalDAV-      │ WebDAV-         │
│ (邮件)   │Calendar- │ Calendar-    │ Files-          │
│          │Client    │ Client       │ Client          │
├──────────┴──────────┴──────────────┴─────────────────┤
│              FastmailAuth (统一认证)                  │
├──────────────────────────────────────────────────────┤
│     JMAP API (邮件) / CalDAV (日历) / WebDAV (文件)   │
└──────────────────────────────────────────────────────┘

核心技术栈：

运行时：Node.js 20+（ESM 模块）
MCP 框架：@modelcontextprotocol/sdk v1.29.0
邮件/JMAP：原生 JMAP HTTP API 调用
日历：CalDAV 协议（tsdav 库）
联系人：JMAP ContactCard
附件处理：WebDAV 文件存储

源码结构：

文件	职责
`index.ts`	MCP 服务器主入口，路由分发，工具注册（最核心，约 110KB）
`jmap-client.ts`	邮件核心：列表、搜索、读取、发送、附件
`caldav-client.ts`	日历 CRUD，recurrence 处理（约 57KB，最大文件）
`contacts-calendar.ts`	联系人管理
`webdav-files-client.ts`	WebDAV 文件操作
`auth.ts`	Fastmail API Token 认证管理
`coerce.ts`	参数校验与敏感信息脱敏
`url-validation.ts`	URL 安全校验（防止 SSRF）

核心功能：AI 助手能做什么

邮件操作（最完整）

读取：按 ID 获取邮件全文、线程对话
搜索：多条件组合过滤（发件人、日期范围、附件、已读状态等）
发送：文本/HTML 邮件，支持回复/转发，自动处理 In-Reply-To 头
草稿管理：创建、编辑、保存草稿
管理：标记已读/未读、删除、移动到文件夹、批量操作
隐私工具：元数据版本（仅返回 metadata，不含邮件正文，适合敏感场景）

日历操作

事件的创建、读取、更新、删除
支持全天事件和定时事件
参与者管理
重复事件（recurrence）识别与更新

联系人操作

联系人列表、搜索、按 ID 获取
创建、更新、删除联系人

附件处理

下载附件并可直接上传到 WebDAV 云存储
支持发送带附件的邮件

上手门槛分析

维度	评估
安装难度	低：`npm install && npm run build`，无编译依赖
配置难度	中：需从 Fastmail Web 界面手动申请 API Token
使用门槛	高：需要 AI 助手支持 MCP 协议（如 Claude Desktop）
认证安全	好：支持多环境变量名匹配，凭证自动脱敏输出
隐私风险	需评估：AI 助手访问邮箱数据涉及隐私，用户需明确授权

在 Claude Desktop 中配置方式（通过 .mcp.json 文件），本质上是一个 JSON 配置声明，将 fastmail-mcp 注册为 Claude Desktop 的 MCP 服务器之一。

局限与风险

非官方项目：免责声明明确，不受 Fastmail 官方支持，可能因 Fastmail API 变更而失效
认证依赖：仅支持 Fastmail 账号，无法对接其他邮件服务商
SSRF 风险：代码中对 URL 做了校验，但附件下载/WebDAV 操作理论上存在 SSRF 风险
无容器化：没有 Dockerfile，跨平台部署需要手动安装 Node.js 环境
MCP 生态锁定：依赖 Claude Desktop 等支持 MCP 协议的 AI 助手

行业意义

fastmail-mcp 代表了一个正在兴起的技术趋势：AI 助手与个人数据源的深度集成。随着 MCP 协议的成熟和推广，我们可能会看到更多类似的"数据桥接器"出现——让 AI 能够访问用户真实的数据资产。

这种模式也带来了新的隐私和安全讨论：AI 助手访问邮件意味着什么级别的数据泄露风险？凭证如何安全管理？这些都是 fastmail-mcp 这类工具无法回避的问题。

总结

fastmail-mcp 是一个设计清晰、实现扎实的 MCP 服务器，适合以下场景：

技术用户：已在使用 Claude Desktop 且需要 AI 助手访问 Fastmail 邮件
开发者：研究 MCP 协议与邮件 API 集成的参考实现
隐私敏感用户：相比授权第三方邮件管理平台，直接控制凭证更透明

不适合：无 MCP 支持的 AI 助手用户、非技术用户（配置门槛较高）。

项目信息：MadLlama25/fastmail-mcp | ⭐ 125 | 🍴 47 | MIT License | TypeScript | 2025-06-15 首次创建