Apple Bridge MCP
Provides tools to access and manage Apple's built-in apps, including listing and creating reminders, searching and creating notes, listing calendars and events, searching contacts, and listing or running Shortcuts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apple Bridge MCP What's on my calendar this week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Bridge MCP
Give Claude access to your Mac's built-in apps — Reminders, Notes, Calendar, Contacts and Shortcuts.
Runs locally over stdio. No cloud, no account, no data leaves your machine.
Why
Claude can write code, but it can't see your calendar or add a reminder. Apple Bridge is a small MCP server that lets it read and write the Apple apps you already use — through the same Apple Events / JXA layer macOS has supported for years.
Local only. The server talks to macOS. Nothing is uploaded.
No API keys. Uses the permissions you already grant to apps.
Small surface. 9 tools, no background daemon, no database.
Related MCP server: iCloud MCP Server Apple
Tools
Tool | What it does |
| List reminders in a list, optionally including completed ones |
| Create a reminder with notes and an ISO 8601 due date |
| Search Apple Notes by title |
| Create a note in a folder |
| List calendars with name, writable flag and description |
| List events in a date range (default: today → +7 days) |
| Search contacts by name, organization, email or phone |
| List the shortcuts installed in the Shortcuts app |
| Run a shortcut by exact name |
Requirements
macOS 13 or newer
Node.js 22 or newer
Claude Desktop, Claude Code, Cursor, or any other MCP client
Install
git clone https://github.com/namvunhatle/apple-bridge-mcp.git
cd apple-bridge-mcp
npm install
npm run buildThis produces dist/cli.js. Point your MCP client at that file with an absolute path.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"apple-bridge": {
"command": "node",
"args": ["/absolute/path/to/apple-bridge-mcp/dist/cli.js"]
}
}
}Restart Claude Desktop.
Claude Code
claude mcp add apple-bridge -- node /absolute/path/to/apple-bridge-mcp/dist/cli.jsCursor
Add the same mcpServers block to ~/.cursor/mcp.json and restart Cursor.
First run: permissions
The first time a tool touches an app, macOS asks:
"Terminal" wants access to control "Reminders".
Click Allow. Each app is granted separately — Reminders, Notes, Calendar, Contacts and Shortcuts.
If you clicked Don't Allow, open:
System Settings → Privacy & Security → Automation
and enable the app under your terminal / Claude Desktop / Cursor.
Examples
Once connected, just ask:
"What's on my calendar this week?"
"Add 'renew passport' to my Errands list, due 2026-12-01 at 9am."
"Find Hương's phone number."
"Save this summary as a note called 'Weekly plan'."
"Run my Battery Stats shortcut."
Configuration notes
list_events defaults
Range: start of today → 7 days ahead.
Reads only writable calendars by default. Read-only calendars (Holidays, Birthdays) can be slow, so pass
includeReadOnly: trueif you need them.Pass
calendarto read a single calendar and skip the rest.Pass explicit ISO 8601
from/tofor any other range.
list_reminders defaults to the Reminders list. Pass another list name, e.g. work.
search_notes matches titles only, not note bodies.
Troubleshooting
Symptom | Fix |
| Grant Automation permission in System Settings → Privacy & Security → Automation, then restart the client |
| Check the exact name; list names are case-sensitive |
Calendar feels slow | Expected: Apple Events take 10–15s across all calendars. Pass |
| Run the tool from a terminal to see the raw error |
Tools missing in Claude | Restart the client after editing the config; check the path is absolute |
Limitations
Things is not supported (planned, requires SQLite + Full Disk Access).
Notes search covers titles only.
Calendar reads through Apple Events; very large calendars are slow. EventKit is the long-term fix.
Shortcuts can run anything, including destructive actions. The tool description asks the model to run shortcuts only on explicit request — treat it accordingly.
Two lists/folders with the same name resolve to the first match.
Accounts with duplicate calendar/list names may need the exact calendar passed explicitly.
Privacy
Apple Bridge makes no network requests. All reads and writes go through macOS Apple Events. The only data it returns is what the tool call asks for.
Development
npm test # unit tests (script builders + shortcuts wrapper)
npm run build # compile TypeScript to dist/
npm start # run the stdio server from source with tsxProject layout:
src/scripts.ts # JXA script builders + escaping
src/osascript.ts # osascript runner + JSON parsing
src/shortcuts.ts # shortcuts CLI wrapper
src/server.ts # MCP server and tool registration
src/cli.ts # stdio entry point
tests/ # node:test suitesLicense
MIT
Available Tools
9 toolscreate_noteC
Create a note in Apple Notes.
Inputs: title (required), body, folder.
create_reminderC
Create a reminder in an Apple Reminders list.
Inputs: title (required), due, list, notes.
list_calendarsB
List macOS Calendar calendars (name, id, writable).
Inputs: no named parameters.
list_eventsA
List calendar events overlapping a date range (default: today to +7 days).
Inputs: to, from, limit, calendar, +1 more.
list_remindersC
List reminders from an Apple Reminders list.
Inputs: list, limit, includeCompleted.
list_shortcutsA
List the names of shortcuts available in the Shortcuts app.
Inputs: no named parameters.
run_shortcutA
Run a shortcut by exact name. Only call when the user explicitly asks to run a shortcut.
Inputs: name (required).
search_contactsC
Search macOS Contacts by name, organization, email or phone.
Inputs: query (required), limit.
search_notesC
Search Apple Notes by title.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool maps to a distinct app resource and action: reminders, notes, calendars/events, contacts, and shortcuts. There is no meaningful overlap between list, create, search, and run operations, so an agent can easily select the right tool.
All tools follow a consistent snake_case verb_noun pattern: list_reminders, create_reminder, search_notes, create_note, list_calendars, list_events, search_contacts, list_shortcuts, and run_shortcut. The convention is predictable throughout.
Nine tools is a well-scoped set for a multi-app Apple bridge, giving each supported app a small number of focused operations. The count is neither bloated nor too thin for the stated cross-app purpose.
The surface is missing core lifecycle operations: reminders and notes can be created but not updated/deleted, calendars/events are read-only, and contacts only support search. These gaps will block common agent tasks such as creating a calendar event or completing/deleting a reminder.
Maintenance
Related MCP Connectors
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables Claude to interact with Apple apps on macOS including Mail, Calendar, Contacts, Reminders, Notes, and iCloud Drive for personal productivity tasks like triaging email, managing calendar, and cross-app context.769MIT
- AlicenseBqualityBmaintenanceEnables Claude to interact with Apple services including Email, Calendar, Contacts, Reminders, Notes, Messages, and Safari via AppleScript (macOS) or iCloud protocols.411,584 npm84MIT
- AlicenseNot gradedqualityDmaintenanceEnables Claude or any MCP client to read Apple Mail, Calendar, Photos, and create Apple Notes locally on macOS, without any data leaving the machine.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Apple Notes, Reminders, and Calendar on macOS through MCP, all locally without API keys.1MIT