Apple MCP

by jxnl
MIT License
206
2
  • Apple

Integrations

  • 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.

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
  • 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 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

A collection of tools that enables Claude AI and Cursor to access native macOS applications such as Messages, Notes, Contacts, Emails, Reminders, Calendar, and Maps through the Model Context Protocol.

  1. Quick install
    1. Features
      1. Manual installation
      2. Usage
    2. Local Development
      ID: xtt9ofyljf