Apple MCP Server

by Dhravya
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows access to Apple native features including Messages, Notes, Contacts, Emails, and Reminders

  • Planned integration to search and open music in Apple Music app (marked as TODO)

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 cursor

Features

  • 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
  • TODO: Search and open calendar events in Apple Calendar app
  • 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 girlfriend
create a reminder to "Buy groceries" for tomorrow at 5pm

Local Development

git clone https://github.com/dhravya/apple-mcp.git cd apple-mcp bun install bun run index.ts

enjoy!

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.

  1. Quick install
    1. Features
      1. Manual installation
      2. Usage
    2. Local Development