Apple Apps Mcp

Apple MCP

Apple MCP 是一款本地 macOS 应用和 MCP 服务，可让 AI 工具受控地访问 Apple 应用。

它包含一个用于权限和客户端配置的 SwiftUI 设置应用，以及一个面向 Codex、Claude Code、Claude Desktop、Raycast 和其他任何兼容 MCP 的应用的 TypeScript 标准输入输出 MCP 服务。

功能

• 原生 macOS 设置应用，提供集成开关和权限状态。
• 通过 EventKit 访问日历和提醒事项。
• 通过 macOS 本地自动化接口接入备忘录、邮件、音乐和快捷指令。
• 通过标准输入输出运行本地 MCP 服务。
• 提供 Codex 和 Claude 的客户端设置辅助功能。
• 针对发送邮件、运行快捷指令和完成提醒事项等高风险操作提供安全防护。

MCP 工具

Apple MCP 提供以下工具：

• apple_permissions_status
• apple_request_permission
• calendar_list_events
• calendar_create_event
• reminders_list
• reminders_create
• reminders_complete
• notes_search
• notes_read
• notes_create
• mail_search
• mail_read
• mail_create_draft
• mail_send_draft
• shortcuts_list
• shortcuts_run
• music_search
• music_play
• music_pause

高风险工具需要设置 confirm: true 并提供简短的原因。

下载

预构建版本可在 Releases 页面下载。

此应用已使用 Developer ID 证书签名并经 Apple 公证，因此可以正常打开，不会出现 Gatekeeper 警告——只需将 Apple MCP 拖到“应用程序”文件夹即可。

要求

• macOS 26 或更高版本
• Xcode 命令行工具 / Swift 工具链
• Node.js 20 或更高版本
• npm

构建并运行

npm install
npm run build
swift build
./script/build_and_run.sh

应用会将本地偏好设置存储在：

~/.apple-apps-mcp/config.json

运行 MCP 服务

npm run dev:mcp

构建完成后，你可以手动注册服务：

codex mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js
claude mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js

设置应用也可以为受支持的 AI 应用写入或显示客户端配置。

权限

日历和提醒事项使用原生 EventKit 权限。设置应用负责在前台请求权限，并运行仅限本地主机的 EventKit 桥接服务，让 MCP 调用共享已获批准的应用上下文。

备忘录、邮件、音乐和快捷指令可能会在首次使用时触发 macOS 自动化权限提示。

开发

npm test
npm run build
swift build
./script/build_and_run.sh --verify

Codex 应用的“运行”按钮通过以下方式连接：

.codex/environments/environment.toml