Apple Native Tools MCP server for AI agents

This collection of Apple-native tools allows your AI assistant to interact with your macOS applications through the Model Context Protocol (MCP). With Apple MCP, you can have your AI assistant control Apple Messages, Notes, Contacts, Emails, Reminders, Calendar, and more on your Mac.

Installation

Quick Install (Recommended)

To install Apple MCP for Claude Desktop automatically using Smithery:

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

For Cursor:

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

Manual Installation

First, install Bun using Homebrew:

brew install oven-sh/bun/bun

Edit your claude_desktop_config.json with the following configuration:

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

Usage

Once installed, you can ask your AI assistant to use the apple-mcp tool for various tasks.

Available Features

Here are examples of commands you can use with Apple MCP:

Messages

Send messages to contacts:
```
Can you send a message to John Doe?
```
Read messages from your conversations

Notes

List notes from Apple Notes

Search and read specific notes:

Find all the notes related to AI and summarize them

Contacts

Search for contact information when sending messages

Emails

Send emails with attachments and multiple recipients
Search emails with custom queries
Schedule emails for future delivery
Manage scheduled emails
Check unread email counts

Reminders

List all reminders and reminder lists
Search for specific reminders

Create new reminders with due dates:

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

Calendar

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

Web Search

Search the web using DuckDuckGo
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 manage guides

Complex Workflows

You can combine multiple commands to create workflows:

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?

How to add this MCP server to 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 > MCP and click "Add new global MCP server".

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

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

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 explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.