Fastmail API
驱动Fastmail JMAP API管理邮件、日历与联系人
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Fastmail API。 它的用途是：驱动Fastmail JMAP API管理邮件、日历与联系人 完整的 Skill 内容见：https://321skill.com/skills/fastmail-api-x-7/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'将最近一周未读的来自newsletter@example.com的邮件标记为已读并归档，同时将发件人添加到联系人分组
介绍
本Skill主要解决通过Fastmail JMAP协议高效管理邮件、搜索、批量处理、发送、掩码邮箱、联系人及日历的问题。它能够在用户提及Fastmail、JMAP、API令牌，或遇到JMAP调用错误（如401、403、unknownCapability等）时自动介入，也适用于需要搜索、归档、移动、标记或删除大量邮件，且需避免误操作其他邮箱的场景。此外，它还支持从别名、身份或自定义域名发送草稿，创建、禁用或审计掩码邮箱，以及通过JMAP读写联系人或日历事件，并支持增量同步或推送订阅保持本地镜像最新，甚至用于邮箱的迁入迁出。
使用方式：用户只需在AI助手中描述需要执行的邮件或日历操作，例如“将来自support@example.com的最近100封邮件归档”或“同步我的Fastmail联系人到本地数据库”，本Skill就会自动调用Fastmail JMAP API完成相应操作。它能够处理复杂的批量操作、错误重试、状态校验，确保操作准确无误。
适合人群：包括智能体开发者、后端开发者和全栈开发者，尤其是需要将Fastmail邮件系统集成到自动化工作流或构建邮件客户端、联系人管理工具的场景。也适合需要批量处理邮件、自动回复客户、同步数据的运维或运营人员。
使用建议：建议在调用前确保已配置Fastmail API令牌，并注意API的速率限制。本Skill不适用于通过IMAP或SMTP协议直接操作邮件，也不适合日常习惯性的收件箱管理（如Apple Mail）。对于需要大量发送邮件的营销场景，建议结合其他工具控制发送频率。
核心特点
与基于IMAP或SMTP的邮件Skill不同，本Skill完全基于JMAP协议，原生支持批量操作、增量同步、掩码邮箱、联系人/日历管理等高级功能，且能处理JMAP特有的错误类型（如unknownCapability、stateMismatch），适合需要精细化、高可靠性的邮件自动化场景。
注意事项
不适用于IMAP客户端、SMTP投递、日常习惯性收件箱管理（如Apple Mail），且需要Fastmail API令牌和网络连接。
常见问题
如何使用Fastmail API令牌？
需要在Fastmail账户设置中生成API令牌，并将令牌配置到本Skill的环境变量或配置文件中。
支持哪些操作？
支持邮件搜索、批量归档/移动/标记/删除、发送邮件（含别名/域名）、创建/禁用/审计掩码邮箱、读写联系人、读写日历事件、增量同步、订阅推送等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastmail-api-x-7/raw/index.md 读取 Fastmail API 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastmail-api-x-7/raw/index.md（查看排版版本）