Apple MCP

What is apple-mcp

apple-mcp is a specialized server developed by Dhravya that provides a suite of Apple-native tools for use with the Model Context Protocol (MCP). The MCP is an open-source protocol designed to facilitate secure communication between AI systems and various data sources. By integrating apple-mcp, AI systems can seamlessly interact with Apple's suite of applications and services, allowing for enhanced functionality and improved user experiences. This server acts as a bridge, enabling AI assistants like Claude to access and manipulate data within Apple Messages, Notes, Contacts, Emails, Reminders, and other applications.

How to Use apple-mcp

Using apple-mcp involves installing it on a platform and setting up configurations to allow communication with AI clients. Here's a quick guide on how to get started:

1. Installation via Smithery:

   • For Claude Desktop, run the following command in your terminal:

     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
     

2. Manual Installation:

   • Ensure you have bun installed. You can do this by running:

     brew install oven-sh/bun/bun
     

   • Update your configuration file (claude_desktop_config.json) with the following:

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

3. Usage:

   • Once installed, you can direct your AI assistant to perform tasks using natural language. For example:
     • "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."

Key Features of apple-mcp

apple-mcp is packed with features that integrate deeply with Apple's ecosystem, allowing AI assistants to perform a wide range of tasks:

• Messages:

  • Send and read messages using the Apple Messages app.

• Notes:

  • List, search, and read notes within the Apple Notes app.

• Contacts:

  • Search contacts for messaging purposes.

• Emails:

  • Send emails with multiple recipients and attachments.
  • Search emails with custom queries and manage mailboxes.
  • Schedule emails for future sending and manage these schedules.
  • Check unread email counts for both global and specific mailboxes.

• Reminders:

  • List and search reminders, create new reminders with due dates and notes, and open the Reminders app.

• Upcoming Features:

  • Integration with Apple Calendar, Photos, and Music for searching and opening events, photos, and music tracks.

Additionally, apple-mcp allows for complex workflows by chaining commands. For example, an AI assistant can read notes, find related contacts, and send messages in a single command, enhancing productivity and user convenience.