Apple MCP

Apple MCP is a local macOS app and MCP server for giving AI tools controlled access to Apple apps.

It includes a SwiftUI setup app for permissions and client configuration, plus a TypeScript stdio MCP server for clients like Codex, Claude Code, Claude Desktop, Raycast, and any other MCP-compatible app.

Features

- Native macOS setup app with integration toggles and permission status.
- Calendar and Reminders access through EventKit.
- Notes, Mail, Music, and Shortcuts adapters through local macOS automation surfaces.
- Local MCP server over stdio.
- Client setup helpers for Codex and Claude.
- Safety guardrails for risky actions like sending mail, running shortcuts, and completing reminders.

MCP Tools

Apple MCP exposes these tools:

- 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

Risky tools require confirm: true and a short reason.

Requirements

- macOS 14 or newer
- Xcode command line tools / Swift toolchain
- Node.js 20 or newer
- npm

Build And Run

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

The app stores local preferences at:

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

Run The MCP Server

npm run dev:mcp

After building, you can register the server manually:

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

The setup app can also write or show client config for supported AI apps.

Permissions

Calendar and Reminders use native EventKit permissions. The setup app owns the foreground permission prompt and runs a localhost-only EventKit bridge so MCP calls share the approved app context.

Notes, Mail, Music, and Shortcuts may trigger macOS Automation prompts on first use.

Development

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

The Codex app Run button is wired through:

.codex/environments/environment.toml