Apple

Collection of apple-native tools for the model context protocol.

typescript

17

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jxnl-apple-mcp": {
      "command": "bunx",
      "args": [
        "--no-cache",
        "apple-mcp@latest"
      ]
    }
  }
}

Apple MCP tools provide Apple-native capabilities for the MCP protocol, enabling you to automate and integrate Apple apps like Messages, Notes, Contacts, Reminders, Calendar, and more through a centralized MCP client workflow. This lets you perform common tasks, orchestrate multi-step actions, and streamline repetitive actions across Apple apps via scripted commands.

How to use

You interact with the Apple MCP server through an MCP client. Start by configuring one or more local MCP endpoints that point to the Apple MCP tool you want to run. Once configured, you can ask your MCP client to perform practical workflows such as sending a message, creating reminders, or locating calendar events. You can also chain commands to create end-to-end workflows, for example reading a note, extracting contacts, and sending a follow-up message.

How to install

Prerequisites you need before installation: a macOS environment with Homebrew and Bun installed, and Node-based tooling available for MCP client integration.

# Optional: install Bun if you do not have it
# Bun is used to run the Apple MCP tool bundles
brew install oven-sh/bun/bun

# Quick install path via Smithery (recommended for Claude Desktop and Cursor integrations)
npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

# Optional second client for cursor workflows
npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

Manual installation

If you prefer a local, self-contained setup, install Bun and configure Claude Desktop to use the local MCP endpoint.

.json
{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["@dhravya/apple-mcp@latest"]
    }
  }
}

Usage examples

Ask Claude to perform common tasks using the configured apple-mcp server. Examples include sending messages, managing notes, creating reminders, and working with calendar events.

# Example prompts you can try in your MCP client
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

Available tools

Messages

Send messages using the Apple Messages app and read incoming messages.

Notes

List notes and search/read notes in Apple Notes.

Contacts

Search contacts to find recipients for messages.

Emails

Send emails with multiple recipients, attachments, and scheduled delivery; manage unread counts.

Reminders

List, search, and create reminders with optional due dates and notes.

Calendar

Search and create calendar events; open events in Calendar app.

Web Search

Perform web searches using DuckDuckGo and process results.

Maps

Search locations, save favorites, and get directions.