Apple-MCPs 是面向 AI 智能体的 Model Context Protocol（MCP）服务器集合，目标是让 AI 客户端在本机使用 Apple 应用和 macOS 工具，例如创建提醒、发送消息、查看日历、搜索邮件、管理文件以及获取路线。
主要能力与组成 提供两类服务器：一个是统一服务器 Apple-Tools-MCP，整合 Mail、Calendar、Reminders、Messages、Contacts、Notes、Shortcuts、Files、System、Maps 十个应用与工具，并附带保存默认值、联系人路由、邮件会话辅助、撤销、简报与跨应用工作流；另一类是针对单个应用的精简服务器，如 apple-mcp-mail、apple-calendar-mcp，可只向客户端暴露较少应用。
使用方式 需 Python 3.11+ 与 macOS，使用 MCP 规范与 Python SDK 2.x，支持较旧的客户端协议版本，MIT 许可。先安装 uv，然后向客户端注册统一服务器；其他 stdio 客户端可直接运行 uvx apple-tools-mcp 启动，独立服务器同理。安装或升级后需重启客户端。Claude Desktop 可从 Releases 下载 .mcpb 包并双击安装。
权限与安全设置 应用级安全模式与目录需在客户端环境变量中设置：显式无效或空白的设置会选择 safe_readonly，未设置则保留各域默认值。邮件附件在设置 APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT 之前处于禁用状态；Files 工具只能访问 APPLE_FILES_MCP_ALLOWED_ROOTS，macOS 可能还有额外限制。统一服务器提供 apple_health、apple_permission_guide、apple_recheck_permissions，权限需用户在 macOS 弹窗或系统设置中自行批准。
工具发现与使用要点 tools/list 返回每个工具的模式与读写标注；可用 search_tools 搜索名称、描述和别名，用 get_tool_info 查看单个工具的 schema 与示例。发送消息前应通过 Contacts 解析收件人，除非已有准确地址；邮件会话可用 mail_get_thread、mail_reply_latest_in_thread、mail_archive_thread，需要指定发件身份时在 from_account 传入准确发件邮箱。邮件搜索需要查询词：发件人、主题片段或 *；Reminders 的 due_date 需要时区偏移，如 yyyy-MM-ddTHH:mm:ss-08:00；发送 iMessage 时省略 service_name。统一服务器还提供 apple_generate_daily_briefing、apple_generate_weekly_briefing、apple_triage_communications_task；不支持 prompt 的客户端可用 apple_list_prompts、apple_get_prompt 及对应服务器的等价工具。从 Python 调用可使用 generated/tool_catalogs/ 中的元数据以及 generated/tool_wrappers/python/ 中的封装。
传输与存储状态 默认使用 stdio；要使用 Streamable HTTP，可设置 APPLE_<DOMAIN>_MCP_TRANSPORT=streamable-http 及对应的 _HOST、_PORT。HTTP 必须绑定 127.0.0.1、::1 或 localhost，服务器没有远程认证并拒绝网络和通配符绑定，不要通过隧道或公共代理暴露。Apple-Tools-MCP 将默认值存于 ~/.apple-tools-mcp/preferences.json，可通过 APPLE_AGENT_MCP_STATE_FILE 配置；最近操作存于 ~/.apple-tools-mcp/actions.json 以供审计和撤销。uv 工作区将各服务器安装到 .venv/bin，每个服务器目录也有 start.sh。
数据边界与限制 服务器运行在用户 Mac 上，但 MCP 客户端可能把返回数据发送给其模型提供方，Apple 应用也可能通过 iCloud 或其他账户同步，因此本地执行不代表数据留在本地。测试方面提供 smoke checks 与官方一致性套件，一致性模式会注册测试夹具，仅用于协议验证。
适用场景 适合希望在 macOS 上让 AI 智能体操作邮件、日历、提醒、消息、联系人、笔记、快捷指令、文件、系统与地图等本地能力的用户，以及需要按应用粒度控制暴露范围的场景。
暂未提供的信息 价格与收费模式、具体版本号、性能数据以及更多使用案例暂未提供。
