This is a collection of apple-native tools for the MCP protocol.
Here's a step-by-step video about how to set this up, with a demo. - https://x.com/DhravyaShah/status/1892694077679763671
Here's the JSON to copy
{
"mcpServers": {
"apple-mcp": {
"command": "bunx",
"args": ["--no-cache", "apple-mcp@latest"]
}
}
}
To install Apple MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude... and for cursor, you can do:
npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor- Messages:
- Send messages using the Apple Messages app
- Read out messages
- Notes:
- List notes
- Search & read notes in Apple Notes app
- Contacts:
- Search contacts for sending messages
- Emails:
- Send emails with multiple recipients (to, cc, bcc) and file attachments
- Search emails with custom queries, mailbox selection, and result limits
- Schedule emails for future delivery
- List and manage scheduled emails
- Check unread email counts globally or per mailbox
- List configured accounts with type and status
- Retrieve detailed account settings
- Display mailbox hierarchy and properties
- List messages from a specific mailbox with filters
- Retrieve attachments and full message headers when listing messages
- Create, delete, rename and move mailboxes
- Reminders:
- List all reminders and reminder lists
- Search for reminders by text
- Create new reminders with optional due dates and notes
- Open the Reminders app to view specific reminders
- Calendar:
- Search calendar events with customizable date ranges
- List upcoming events
- Create new calendar events with details like title, location, and notes
- Open calendar events in the Calendar app
- Web Search:
- Search the web using DuckDuckGo
- Retrieve and process content from search results
- Maps:
- Search for locations and addresses
- Save locations to favorites
- Get directions between locations
- Drop pins on the map
- Create and list guides
- Add places to guides
- Photos:
- Search photos by name
- Open a specific photo
- Music:
- Search library songs
- Play a specific song
You can also daisy-chain commands to create a workflow. Like: "can you please read the note about people i met in the conference, find their contacts and emails, and send them a message saying thank you for the time."
(it works!)
You just need bun, install with brew install oven-sh/bun/bun
Now, edit your claude_desktop_config.json with this:
{
"mcpServer
663F
s": {
"apple-mcp": {
"command": "bunx",
"args": ["@dhravya/apple-mcp@latest"]
}
}
}Now, ask Claude to use the apple-mcp tool.
Can you send a message to John Doe?
find all the notes related to AI and send it to my girlfriend
create a reminder to "Buy groceries" for tomorrow at 5pm
create a mailbox "Project" under "Work" account and then move it into "Archive"
git clone https://github.com/dhravya/apple-mcp.git
cd apple-mcp
bun install
bun run lint
bun test
bun run index.tsenjoy!