技能介绍

要解决什么问题

在自动化流程里处理邮件，通常有两条路：自己写 AppleScript，或者让模型对着一个邮箱挨个点开邮件。前者维护成本高，脚本一旦邮件规则变了就容易出错；后者则把整个收件箱暴露给模型，上下文会迅速膨胀，动作也不受约束。

这个技能要解决的是：让邮件处理留在有界的代理工作流里。它通过 Apple Mail MCP 把邮箱的读取、搜索、发送、会话串接、模板填充和整理能力封装成一组 MCP 工具，供 Claude Desktop 这类 MCP 兼容客户端调用。模型不需要知道 AppleScript 的细节，也不需要一次加载全部邮件正文，只需要按任务调用对应工具。

核心能力与工作方式

搜索与读取：代理可以按关键词、发件人等条件在 Apple Mail 里搜索，再按需取回具体邮件内容，而不是一次性拉取整个邮箱。
发送与回复：支持构造新邮件并发送，也能在现有会话线程上继续回复，保持上下文连贯。
模板与整理：可用模板快速填充邮件，并对邮件做归档、分类等整理动作，让收件箱维持在一个可控状态。
运行形态：技能以 MCP server 形式暴露能力，客户端通过类似 python -m apple_mail_mcp.server 的方式启动服务，之后代理按工具调用完成任务。

典型的使用路径是：代理先搜索相关邮件，确认关键信息，再决定是回复、转发还是归档，整个过程只在它需要的邮件范围内操作。

适用边界与注意点

仅限 macOS：需要 macOS 10.15（Catalina）或更高版本，并且 Apple Mail 里至少配置好一个账号。
依赖 Python 环境：需要 Python 3.10+，以及 uv 或 pip 之一来管理依赖。
Pre-1.0 阶段：上游明确标注 API 尚未稳定。工具名、参数和返回结构都可能随版本变化，存在破坏性变更风险。建议锁定具体版本，例如 apple-mail-mcp==0.8.1，并在升级前仔细阅读变更说明。
权限与稳定性：技能直接操作本机 Apple Mail，发送动作会真实发出邮件，整理动作也会改动本地邮箱状态，建议先在测试账号上验证行为。