核心功能
fastmail-jmap 是一个专为 AI agent 设计的邮件管理技能，基于 Fastmail 的现代 JMAP 协议实现完整的邮件生命周期管理。该技能采用纯 Python 标准库编写，零外部依赖，单文件约300行代码即可实现收件箱浏览、全文搜索、邮件阅读、发送、移动、标记已读/未读、删除等核心功能。
显著优点
极简集成：无需 pip 安装、无需 OAuth 流程、无需配置文件，仅需一个 API token 即可运行，大幅降低了 agent 接入邮件系统的门槛。性能优越：JMAP 作为 Fastmail 专为替代 IMAP 设计的现代协议，采用 HTTP JSON 架构，支持批量请求，响应速度显著优于传统 IMAP/SMTP 方案。隐私优先：Fastmail 本身无广告、无邮件扫描，配合 API token 的细粒度权限控制，比 Gmail OAuth 方案更符合隐私敏感场景。成本低廉：Fastmail 基础版仅 $5/月，支持自定义域名，适合个人开发者和小型 agent 部署。
潜在局限
厂商锁定：仅支持 Fastmail 服务，无法迁移至 Gmail、Outlook 等其他邮件提供商。功能边界：作为轻量级实现，暂不支持附件处理、HTML 邮件渲染、邮件签名管理、复杂过滤器设置等高级功能。令牌管理：API token 为长期凭证，若泄露则风险较高，需依赖外部 secret 管理工具（如 1Password）。无本地缓存：纯无状态设计，每次查询都访问云端，高频场景下可能受 API 限流影响。
适合人群
个人开发者、AI agent 构建者、solopreneur（一人创业者）、隐私敏感用户，以及需要为 agent 快速集成邮件能力但不愿处理 Gmail OAuth 复杂性的技术团队。特别适合已使用或愿意迁移至 Fastmail 生态的用户。
常规风险
API token 泄露风险为首要关注点，需确保 FASTMAIL_TOKEN 存储于安全环境变量或 secrets 管理工具，避免硬编码或日志泄露。发送邮件功能需设置人工确认流程，防止 agent 自动发送不当内容。此外，JMAP 的日期处理采用 UTC 时间，跨时区场景需注意时间换算；搜索功能默认全局执行，敏感邮件可能意外暴露于搜索结果中。