🍎 apple-mcp

Give your AI assistant hands on your Mac — Apple Notes, Reminders, and Calendar over MCP.

No API keys · No cloud · No accounts · 100% local · Free forever

Once connected, you just talk:

• 🗓️ "What's on my calendar this week?"

• ✅ "Remind me to call the dentist tomorrow at 9am"

• 📝 "Find my note about the Japan trip and summarize it"

• ✨ "Save this meeting summary as a note and add the action items to my Reminders"

apple-mcp is an MCP server that connects Claude Desktop, Claude Code, or any MCP client to the Apple apps you already use — through macOS's built-in automation. Your data never leaves your Mac except through the AI client you choose to connect.

⚡ Install in 60 seconds

You need a Mac and Node.js 18+ (check with node --version).

git clone https://github.com/open-first/apple-MCP.git
cd apple-MCP
npm install

That's the whole install — npm install builds the server too.

Related MCP server: macuse

🔌 Connect it

Claude Desktop — add this to ~/Library/Application Support/Claude/claude_desktop_config.json (create the file if it doesn't exist), with the absolute path to your clone:

{
  "mcpServers": {
    "apple": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/apple-MCP/dist/index.js"]
    }
  }
}

Then quit Claude fully (⌘Q — closing the window isn't enough) and reopen it. The tools appear under the 🔌/sliders icon.

Claude Code — one command:

claude mcp add apple -- node /Users/YOUR_USERNAME/apple-MCP/dist/index.js

Any other MCP client — it's a standard stdio server: node dist/index.js.

🔐 First run: click "Allow"

The first time a tool touches each app, macOS asks — "Claude would like to control Notes". Click Allow, once per app. That's the only setup.

(Denied it by accident? System Settings → Privacy & Security → Automation → find Claude → flip the toggles on.)

🧰 What it can do

12 tools across three apps:

Read tools are marked read-only and delete is marked destructive, so well-behaved MCP clients ask you before anything risky happens.

🩹 Troubleshooting

🛠️ Add more Apple apps

Every app is one file in src/modules/ — small automation scripts plus tool definitions, usually under 150 lines. User input is passed as JSON data, never pasted into script code, so there's no injection risk.

Mail, Messages, and Contacts are next on the roadmap — and CONTRIBUTING.md shows exactly how to add one. PRs welcome!

💬 Why this exists

A Reddit comment asked for one app connecting Apple Reminders, Notes, and Calendar to AI: "It's crazy that Apple hasn't done this yet." Apple still hasn't. So here it is — free, for everyone.

📄 License

MIT — do whatever you want with it.