Apple MCP Server

🚀 Apple MCP Tool

This is a collection of tools designed for Apple devices based on the MCP Protocol. It aims to provide convenient functions for interacting with Apple's native applications.

Here is a step-by-step video on how to set up and demonstrate the tool: Watch the video

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

🚀 Quick Start

📦 Installation

Quick Installation

Automatically install Apple MCP for Claude Desktop via Smithery:

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

... For Cursor, you can do this:

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

Manual Installation

1. Install Node.js and npm:

# Install Node.js 14.x or higher using nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts

2. Clone the repository and install dependencies:

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

3. Start the service:

node index.js

✨ Features

• Messages:
  • Send messages using the Apple Messages app.
  • Announce message content.
• Notes:
  • List all notes.
  • Search for and read notes in the Apple Notes app.
• Contacts:
  • Search for contacts to get information for sending messages.
• Mail:
  • Send emails with multiple recipients (including CC and BCC).
  • Search for emails using custom queries, mailbox selection, and result limits.
  • Schedule emails for future delivery.
  • List and manage scheduled emails.
  • Check the number of unread emails globally or by mailbox.
• Reminders:
  • List all reminders and reminder lists.
  • Search for reminders by text.
  • Create new reminders, optionally with a due date and notes.
  • Open specific reminders in the Reminders app.
• Calendar:
  • Search for calendar events using a custom date range.
  • List upcoming events.
  • Create new calendar events with details such as title, location, and notes.
  • Open specific calendar events in the Calendar app.
• Web Search:
  • Perform web searches on platforms like Google.
  • Get a list of search results.
  • Open specified search result links.
• Maps:
  • Search for geographical locations and get latitude and longitude coordinates.
  • View location information.

💻 Usage Examples

Basic Usage

Send an Email

{
  "command": "send_email",
  "args": {
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email from the MCP tool."
  }
}

Search for a Geographical Location

{
  "command": "search_location",
  "args": {
    "query": "New York City"
  }
}

Advanced Usage

• Get weather information: { command: 'get_weather', args: { location: 'London' } }
• Search for nearby restaurants: { command: 'search_restaurants', args: { location: 'Tokyo' } }

🔧 Local Development

1. Clone the repository and install dependencies:

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

2. Start the development server:

npm run dev

3. Test the functionality:

• Visit http://localhost:3000 to view the documentation and test interface.
• Use the provided API interfaces to test the functionality.

For more detailed information, please refer to the project documentation or the README file in the repository.

📚 Documentation

• Official MCP Protocol Documentation
• Smithery Platform
• Official Node.js Website
• Official NPM Repository