Apple MCP Server

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

local-only server

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

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

      Related MCP Servers

      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.
        Last updated -
        TypeScript
        • Apple
      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.
        Last updated -
        6
        TypeScript
        • Apple
      • A
        security
        A
        license
        A
        quality
        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.
        Last updated -
        8
        756
        2
        TypeScript
        MIT License
        • Apple
      • -
        security
        -
        license
        -
        quality
        A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.
        Last updated -
        2
        Python
        MIT License
        • Apple

      View all related MCP servers

      ID: gq2qg6kxtu