Skip to main content
Glama
Apple MCP
by jxnl

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

image

{
  "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

Related MCP server: Local MCP

Local Development

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

enjoy!

Available Tools

7 tools
calendarC

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

    A3.5/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      Not graded
      maintenance
      A 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.
      8
      1
      -
    • F
      license
      C
      quality
      B
      maintenance
      Local 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.
      404
      80
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      8
      62 PyPI
      2
      MIT