Overview
What is Apple Apps Mcp?
Apple Apps Mcp is a local macOS app and MCP server that gives AI tools controlled access to Apple apps, such as Calendar, Reminders, Notes, Mail, Music, and Shortcuts. It includes a SwiftUI setup app for managing permissions and client configuration, plus a TypeScript stdio MCP server compatible with clients like Codex, Claude Desktop, and Raycast.
How to use Apple Apps Mcp?
Build and run the app by running npm install, npm run build, swift build, and ./script/build_and_run.sh. After building, start the MCP server with npm run dev:mcp. You can register the server manually for supported clients, for example codex mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js or claude mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js. The setup app can also write or show client configuration for supported AI apps.
Key features of Apple Apps Mcp
- Native macOS setup app with integration toggles and permission status.
- Calendar and Reminders access through EventKit.
- Notes, Mail, Music, and Shortcuts adapters via local macOS automation.
- Local MCP server over stdio.
- Client setup helpers for Codex and Claude.
- Safety guardrails for risky actions like sending mail or running shortcuts.
Use cases of Apple Apps Mcp
- AI assistant scheduling calendar events and managing reminders.
- Automating note creation and search from an AI interface.
- Drafting and sending emails under user confirmation.
- Running macOS Shortcuts through an AI tool.
- Controlling Music playback (play/pause/search) via natural language.
FAQ from Apple Apps Mcp
What are the system requirements for Apple Apps Mcp?
macOS 14 or newer, Xcode command line tools / Swift toolchain, Node.js 20 or newer, and npm.
Where does Apple Apps Mcp store its configuration?
Local preferences are stored at ~/.apple-apps-mcp/config.json.
How does Apple Apps Mcp handle permissions?
Calendar and Reminders use native EventKit permissions; the setup app handles the foreground permission prompt and runs a localhost-only EventKit bridge. Notes, Mail, Music, and Shortcuts may trigger macOS Automation prompts on first use.
What are “risky” tools and how are they used?
Risky tools (e.g., sending mail, running shortcuts, completing reminders) require confirm: true and a short reason to be executed, providing a safety guardrail.
How can I register Apple Apps Mcp with Codex or Claude?
After building, run codex mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js or claude mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js. The setup app can also write client config automatically.
