Skip to content

Dhravya/apple-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Apple MCP tools

smithery badge

This is a collection of apple-native tools for the MCP protocol.

Here's a step-by-step video about how to set this up, with a demo. - https://x.com/DhravyaShah/status/1892694077679763671

image

Here's the JSON to copy
{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "apple-mcp@latest"]
    }
}

Quick install

To install Apple MCP for Claude Desktop automatically via Smithery:

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

... and for cursor, you can do:

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

Features

  • Messages:

    • Send messages using the Apple Messages app
    • Read out messages
  • Notes:

    • List notes
    • Search & read notes in Apple Notes app
  • Contacts:

    • Search contacts for sending messages
  • Emails:

    • Send emails with multiple recipients (to, cc, bcc) and file attachments
    • Search emails with custom queries, mailbox selection, and result limits
    • Schedule emails for future delivery
    • List and manage scheduled emails
    • Check unread email counts globally or per mailbox
  • Reminders:

    • List all reminders and reminder lists
    • Search for reminders by text
    • Create new reminders with optional due dates and notes
    • Open the Reminders app to view specific reminders
  • TODO: Search and open calendar events in Apple Calendar app

  • TODO: Search and open photos in Apple Photos app

  • TODO: Search and open music in Apple Music app

You can also daisy-chain commands to create a workflow. Like: "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."

(it works!)

Manual installation

You just need bun, install with brew install oven-sh/bun/bun

Now, edit your claude_desktop_config.json with this:

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

Usage

Now, ask Claude to use the apple-mcp tool.

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

Local Development

git clone https://github.com/dhravya/apple-mcp.git
cd apple-mcp
bun install
bun run index.ts

enjoy!

About

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

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published