Apple Native Tools MCP server

This Node.js package enables you to interact with Apple's native apps and services through the Model Context Protocol (MCP). It allows AI assistants like Claude to perform actions such as sending messages, managing notes, searching contacts, handling emails, and more directly from your Apple device.

Installation Options

Quick Install via Smithery

To automatically install Apple MCP for Claude Desktop:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

For Cursor, use:

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

Manual Installation

1. Install Bun if you don't have it:

brew install oven-sh/bun/bun

2. Edit your claude_desktop_config.json to include:

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

Using Apple MCP

Once installed, you can ask Claude to use the apple-mcp tool for various tasks across Apple apps and services.

Messages

Send and read messages from the Apple Messages app:

Can you send a message to John Doe?

Notes

Work with the Apple Notes app:

Find all the notes related to AI and send it to my girlfriend

Reminders

Create and manage reminders:

Create a reminder to "Buy groceries" for tomorrow at 5pm

Emails

Send and manage emails:

• Send emails with attachments
• Search emails with custom queries
• Schedule emails for future delivery
• Check unread email counts

Calendar

Interact with your calendar:

• Search events
• List upcoming events
• Create new events
• Open events in the Calendar app

Contacts

Search through your contacts for information or to send messages.

Web Search

Search the web using DuckDuckGo.

Maps

Interact with Apple Maps:

• Search locations
• Save favorites
• Get directions
• Create and manage guides

Advanced Usage

You can daisy-chain commands to create workflows. For example:

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?

This will execute multiple actions in sequence to complete a complex task.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "apple-mcp" '{"command":"bunx","args":["--no-cache","apple-mcp@latest"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect