Fastmail JMAP 是一个专为 AI 代理设计的轻量级邮件操作工具，通过 Fastmail 的 JMAP API 实现零依赖的电子邮件管理。该工具由 The Agent Wire 团队开发，旨在解决传统邮件服务（如 Gmail）因 OAuth2 授权流程复杂而难以被自动化代理集成的问题。它允许 AI 代理直接读取、搜索、发送、移动和删除邮件，无需安装额外依赖库，仅需 Python 3 标准库即可完成所有操作。其核心优势在于使用 JSON 格式的 JMAP 协议替代传统的 IMAP/SMTP，支持批量请求、无状态查询，极大提升了处理效率与可靠性。整个系统仅由一个约 300 行的 Python 脚本构成，部署简单，适合集成到各类智能工作流中。
核心功能特点
- 纯 Python 实现，无需 pip 安装，仅依赖 Python 3 标准库
- 支持完整的邮件操作：查看收件箱、搜索邮件、阅读内容、发送新邮件、标记已读/未读、移动至文件夹或垃圾箱
- 基于 Fastmail 的 JMAP 协议，避免复杂的 OAuth2 授权流程，仅需一个 API token
- 支持全局搜索并可通过发件人、日期范围等条件精确过滤结果
- 可列出所有邮箱文件夹及其邮件数量，便于组织邮件结构
- 适用于心跳检测或定时任务，自动扫描紧急邮件并触发通知
适用场景
Fastmail JMAP 特别适合需要自动化处理日常邮件任务的 AI 代理场景。例如，在每日早晨执行 inbox 扫描时，代理可调用 `unread` 命令快速获取未读邮件列表，识别出包含发票、会议邀请或重要客户消息的内容，并生成摘要供用户决策。对于财务类代理，可通过 `search “receipt” –after 2026-02-01` 精准定位本月收据邮件，提取金额与商家信息，辅助记账流程。若收到来自老板的关键指令邮件，代理可利用 `read ` 获取正文详情，并结合日历工具安排后续行动。在客户服务场景中，代理可在确认后通过 `send` 命令快速回复客户，提升响应速度。此外，结合 Sieve 过滤器，代理还能将特定主题的邮件自动归档至指定文件夹，实现人机协同的高效邮件管理。无论是个人助理型代理还是企业级 RAG 应用，该工具都能显著降低邮件集成的技术门槛。