What is Apple MCP Tools

Apple MCP tools is a collection of native applications designed for the Model Context Protocol (MCP), enabling users to interact with Apple services like Messages, Notes, Calendar, and more through workflow automation.

Use cases

Users can send messages, manage notes, schedule emails, create reminders, and conduct web searches, making it ideal for personal productivity, communication, and task management. It allows for complex command chaining, enabling workflows that combine multiple actions seamlessly.

How to use

To use the Apple MCP tools, install via Smithery CLI with commands tailored for clients like Claude Desktop or Cursor. Users can also manually configure their setup by editing their claude_desktop_config.json file to specify command parameters.

Key features

The tools include features for messaging, note management, contact searches, email functionalities (including scheduling and searching), reminders, calendar events, web searches, and maps for location services. Additional features are planned for photo and music management.

Where to use

These tools can be used with compatible applications such as Claude Desktop and Cursor, making them accessible for users in personal and professional environments to streamline their tasks and interactions with Apple products.

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!