Apple MCP
The Apple MCP server provides a unified interface to interact with native Apple apps and services:
Contacts: Search and retrieve contacts
Notes: Search, list, and create notes
Messages: Send, read, schedule, and check unread messages
Mail: Read unread emails, search emails, send emails with attachments, list mailboxes
Reminders: Search, create, list, and open reminders
Web Search: Search the web using DuckDuckGo and retrieve content
Calendar: Search, create, open, and list calendar events
Maps: Search locations, save favorites, get directions, manage guides, and add places to guides
Enables interaction with native Apple applications and services, providing access to Messages, Notes, Contacts, Mail, Reminders, and Calendar for sending messages, reading/searching notes, managing contacts, sending/scheduling emails, creating reminders, and managing calendar events.
Mentioned as a planned future feature to search and open music in Apple Music app.
Enables web search functionality using DuckDuckGo to retrieve and process content from search results.
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 MCP send a message to John Doe about our meeting tomorrow at 3pm"
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 MCP tools
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
{
"mcpServers": {
"apple-mcp": {
"command": "bunx",
"args": ["--no-cache", "apple-mcp@latest"]
}
}
Quick install
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 cursorFeatures
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
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
TODO: Search and open photos in Apple Photos app
TODO: Search and open music in Apple Music app
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!)
Manual installation
You just need bun, install with brew install oven-sh/bun/bun
Now, edit your claude_desktop_config.json with this:
{
"mcpServers": {
"apple-mcp": {
"command": "bunx",
"args": ["@dhravya/apple-mcp@latest"]
}
}
}Usage
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 girlfriendcreate a reminder to "Buy groceries" for tomorrow at 5pmRelated MCP server: Local MCP
Local Development
git clone https://github.com/dhravya/apple-mcp.git
cd apple-mcp
bun install
bun run index.tsenjoy!
Available Tools
7 toolscalendarC
Search, create, and open calendar events in Apple Calendar app
Inputs: operation (required), searchText, eventId, limit, +9 more.
contactsB
Search and retrieve contacts from Apple Contacts app
Inputs: name.
mailC
Interact with Apple Mail app - read unread emails, search emails, and send emails
Inputs: operation (required), account, mailbox, limit, +6 more.
mapsC
Search locations, manage guides, save favorites, and get directions using Apple Maps
Inputs: operation (required), query, limit, name, +5 more.
messagesC
Interact with Apple Messages app - send, read, schedule messages and check unread messages
Inputs: operation (required), phoneNumber, message, limit, +1 more.
notesC
Search, retrieve and create notes in Apple Notes app
Inputs: operation (required), searchText, title, body, +1 more.
remindersC
Search, create, and open reminders in Apple Reminders app
Inputs: operation (required), searchText, name, listName, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool corresponds to a distinct Apple app (Calendar, Contacts, Mail, Maps, Messages, Notes, Reminders) with clearly separated purposes. There is no overlap in functionality, as each tool handles a specific domain like events, contacts, emails, locations, messages, notes, or reminders, making tool selection straightforward for an agent.
All tool names are singular nouns (calendar, contacts, mail, maps, messages, notes, reminders) that directly reference the Apple apps they interact with. This consistent naming pattern is simple, predictable, and enhances readability across the tool set.
With 7 tools, the server is well-scoped for its purpose of interacting with Apple's core productivity apps. Each tool earns its place by covering a major app, avoiding bloat while providing comprehensive coverage across common user workflows like communication, organization, and navigation.
The tool set offers strong coverage for basic CRUD operations across key Apple apps, such as searching, creating, and retrieving items. Minor gaps exist, like no explicit update or delete operations in some tools (e.g., notes, reminders), but agents can likely work around this using create and search functions for most use cases.
Maintenance
Related MCP Connectors
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Your AI apps as one team: hand work to Codex or Claude Code on your Mac, with a shared logbook.
Mail, Calendar, Messages, Notes, Contacts, Slack on your Mac for AI. Remote needs Pro or free trial.
Related MCP Servers
- FlicenseBqualityNot gradedmaintenanceA collection of tools that enable AI assistants to interact with Apple applications and services including Contacts, Notes, Messages, Mail, Reminders, Calendar, Maps, and Web Search through the Model Context Protocol.81-
- FlicenseCqualityBmaintenanceLocal tools that let your AI use Mail, Calendar, Contacts, Teams, Slack, WhatsApp, OneDrive, Google Drive, Notion, Outlook and Office files on Mac and Windows. Runs on your computer. Works with Claude, ChatGPT, Codex, Cursor and other MCP clients.40480-
- AlicenseAqualityCmaintenanceEnables Claude to interact with WhatsApp on macOS through the Model Context Protocol. It allows reading messages, searching contacts, listing chats, and sending replies via natural conversation.862 PyPI2MIT
- FlicenseBqualityDmaintenanceExposes macOS system controls and Apple apps as structured tools for Claude, enabling control of volume, music, files, browser tabs, and more via natural language with configurable permissions and rate limiting.311-