Fastmail API
通过JMAP协议驱动Fastmail邮件、日历和联系人
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Fastmail API。 它的用途是:通过JMAP协议驱动Fastmail邮件、日历和联系人 完整的 Skill 内容见:https://321skill.com/skills/fastmail-api-x-3/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我通过Fastmail API搜索最近一周来自客户support@example.com的邮件,并全部归档到'项目归档'文件夹,同时标记为已读。' 它会调用JMAP的Mailbox/query和Email/set方法,批量移动并更新状态,返回操作结果。
介绍
解决什么问题 当您需要深度管理Fastmail邮箱时,传统IMAP/SMTP无法应对批量操作、蒙面邮箱、增量同步、联系人/日历读写等复杂场景。本Skill直接调用Fastmail的JMAP API,可高效处理数千封邮件的搜索、归档、移动、标记、删除,并支持通过别名/身份/自定义域名发送草稿,创建和管理蒙面邮箱地址,读写联系人与日历事件,以及执行增量同步或推送订阅以保持本地镜像最新。
怎么用 在支持MCP协议的AI平台(如Claude、Cursor)中安装本Skill后,只需自然语言描述需求即可。例如:“搜索上周所有来自support@company.com的邮件并归档到’Support’文件夹”、“创建一个新的蒙面邮箱用于临时注册”、“将明天10点的日历事件改为11点”。Skill会自动构造JMAP调用,处理分页、错误重试、状态同步等底层细节,并返回结构化结果。
适合谁 后端开发者需要集成Fastmail邮件功能;全栈开发者构建邮箱管理、批量通知或联系人同步工具;运维工程师迁移企业邮箱或监控邮件系统;以及任何需要以编程方式高效管理Fastmail账户的用户。
使用建议 使用前需获取Fastmail API Token(设置→密码与安全→API令牌)。建议先在小范围测试批量操作,避免误删重要邮件。对于大量历史邮件迁移,可配合增量同步功能逐步完成。注意:本Skill不适用于IMAP客户端(如Thunderbird)、SMTP投递、日常收件箱手动整理或Apple Mail,请使用相应的专用工具。
核心特点
专门针对Fastmail的JMAP协议,原生支持蒙面邮箱、增量同步、联系人/日历读写,而其他邮件Skill通常只支持IMAP/SMTP或通用邮件协议,无法处理Fastmail特有的功能。
注意事项
不适用于IMAP客户端、SMTP投递、日常收件箱手动整理或Apple Mail,且需要有效的Fastmail API Token。
常见问题
如何获取Fastmail API Token?
登录Fastmail网页版,进入设置→密码与安全→API令牌,创建具有所需权限的令牌。
支持哪些JMAP端点?
支持邮件、搜索、批量整理、发送、蒙面邮箱、联系人、日历等核心JMAP端点,以及增量同步和推送订阅。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/fastmail-api-x-3/raw/index.md 读取 Fastmail API 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/fastmail-api-x-3/raw/index.md(查看排版版本)