Fastmail MCP Server

基本能力

产品定位

Fastmail MCP Server 是一个用于连接 Fastmail 或其他基于 JMAP 的电子邮件服务的 MCP 服务器。

核心功能

• 列出所有邮箱及其详细信息
• 搜索邮件线程
• 列出邮件线程
• 列出线程中的邮件
• 获取邮件详情
• 移动邮件线程到指定邮箱
• 标记邮件线程为已读或未读
• 归档邮件线程
• 删除邮件线程（软删除）

适用场景

• 电子邮件管理
• 自动化邮件处理
• 邮件分类和归档

工具列表

• list-mailboxes: 列出所有邮箱，包括 ID、名称、角色、总邮件数和未读邮件数
• search-threads: 按主题、发件人、收件人、正文等搜索邮件线程
• list-threads: 列出邮箱中的邮件线程或所有邮箱的所有线程
• list-thread-messages: 列出线程（对话）中的邮件
• get-email-details: 获取邮件的详细信息
• move-threads-to-mailbox: 将一个或多个线程中的所有邮件移动到目标邮箱
• mark-threads-read: 将一个或多个线程中的所有邮件标记为已读
• mark-thread-unread: 将线程中的邮件标记为未读（全部或仅最后一条）
• archive-threads: 将一个或多个线程中的所有邮件移动到归档邮箱
• delete-threads: 将一个或多个线程中的所有邮件移动到垃圾箱（软删除）

常见问题解答

• 如何获取 JMAP_BEARER_TOKEN？
• 需要从 Fastmail 或其他 JMAP 电子邮件服务提供商获取 API 令牌。
• 如何更改 JMAP_SESSION_URL？
• 如果使用非 Fastmail 的电子邮件服务提供商，需要替换为相应的会话 URL。

使用教程

使用依赖

• MCP server 使用官方的 @modelcontextprotocol/sdk
• JMAP 电子邮件访问通过 jmap-jam

安装教程

1. 克隆仓库 sh git clone https://github.com/gnapse/fastmail-mcp
2. 安装依赖并设置环境 sh npm run setup
3. 配置 mcp.json json { "mcpServers": { "fastmail-mcp": { "type": "stdio", "command": "node", "args": [ "/Users/<your_user_name>/code/fastmail-mcp/dist/mcp-server.js" ], "env": { "JMAP_BEARER_TOKEN": "your-jmap-bearer-token-here", "JMAP_SESSION_URL": "https://api.fastmail.com/jmap/session" } } } }
4. 更新配置
   • 替换 JMAP_BEARER_TOKEN 为你的 Fastmail API 令牌
   • （可选）如果使用其他电子邮件服务提供商，替换 JMAP_SESSION_URL
   • 替换 args 数组中的路径为克隆仓库的正确路径

调试方式

1. 运行 MCP 服务器 sh npm run dev
2. 更新构建 sh npm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。