@chrimerss/apple-mcp-enhanced
v1.1.1
Published
Enhanced Apple MCP tools with email folder management, contacts, notes, messages, and mail integration
Downloads
23
Maintainers
Readme
Apple MCP Tools Enhanced
This is an enhanced collection of apple-native tools for the MCP protocol with advanced email folder management capabilities.
🚀 What's New in Enhanced Version
- ✨ Create email folders/mailboxes with support for nested folders
- 📧 Move emails to folders using flexible search criteria
- 🗂️ Email organization tools for better inbox management
- 📁 Account-specific folder creation for multi-account setups
{
"mcpServers": {
"apple-mcp-enhanced": {
"command": "npx",
"args": ["@chrimerss/apple-mcp-enhanced@latest"]
}
}
}Quick install
To install the Enhanced Apple MCP for Claude Desktop:
npx @chrimerss/apple-mcp-enhanced@latestOr add it to your Claude Desktop configuration:
{
"mcpServers": {
"apple-mcp-enhanced": {
"command": "npx",
"args": ["@chrimerss/apple-mcp-enhanced@latest"]
}
}
}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
- NEW: Create mailboxes/folders with support for nested folders and account-specific creation
- NEW: Move emails to folders with flexible search criteria (subject, sender, date)
- NEW: Email organization tools for better inbox management
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
Calendar:
- Search calendar events with customizable date ranges
- List upcoming events
- Create new calendar events with details like title, location, and notes
- Open calendar events in the Calendar app
Web Search:
- Search the web using DuckDuckGo
- Retrieve and 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 list guides
- Add places to guides
TODO: Search and open photos in Apple Photos app
TODO: Search and open music in Apple Music app
Email Folder Management Examples
With the new email folder management features, you can now:
Create a new folder called "Important Projects" in my work email accountMove all emails from John Doe about the quarterly report to the "Q4 Reports" folderCreate a nested folder "Archive" under "Important Projects" and move old emails thereOrganize my inbox by moving all emails with "meeting" in the subject to a "Meetings" folderYou 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-enhanced": {
"command": "npx",
"args": ["@chrimerss/apple-mcp-enhanced@latest"]
}
}
}Usage
Now, ask Claude to use the apple-mcp-enhanced tool.
Can you send a message to John Doe?find all the notes related to AI and send it to my girlfriendcreate a reminder to "Buy groceries" for tomorrow at 5pmCreate a folder called "Work Projects" and move all emails from my boss to itLocal Development
git clone https://github.com/chrimerss/apple-mcp.git
cd apple-mcp
bun install
bun run index.tsenjoy!
