Apple MCP - Enhanced Edition

**Enhanced by @Ayaanisthebest**

Based on the original work by supermemoryai/apple-mcp

Overview

This enhanced version of Apple MCP extends the original supermemoryai/apple-mcp repository with additional features and improvements. The original project provides a comprehensive Model Context Protocol server for Apple ecosystem integration, enabling AI assistants to interact with native Apple applications.

Enhanced Features

Smart Contact Resolution

• Automatic contact name to phone number resolution in the Messages tool
• Eliminates manual contact lookup requirements before messaging
• Intelligent phone number parsing with international format preference

Enhanced Notes Management

• Priority-based search algorithm prioritizing title matches over content
• Visual indicators for search result types (Title Match vs Content Match)
• Full support for Apple Notes rich text formatting and structure
• Advanced note editing capabilities with format preservation

Improved Error Handling

• Enhanced validation and user-friendly error messaging
• Comprehensive error guidance and troubleshooting
• Advanced debugging and logging capabilities

Developer Experience Improvements

• Enhanced TypeScript interfaces and type validation
• Improved code organization and maintainability
• Comprehensive debugging and development tools

Core Functionality

Messages

• Send messages using contact names with automatic phone number resolution
• Access message history and conversation threads
• Schedule messages for future delivery
• Enhanced error handling and validation

Notes

• Advanced search with priority-based result ranking
• Rich text creation and editing with full formatting support
• Note organization and folder management
• Content modification while preserving formatting

Contacts

• Comprehensive contact search and retrieval
• Phone number and email address management
• Required integration step for messaging operations

Mail

• Email composition with attachment, CC, and BCC support
• Advanced email search and filtering
• Scheduled email delivery
• Unread message monitoring

Reminders

• Task creation with due date management
• Advanced reminder search and organization
• Comprehensive reminder listing and management
• Direct reminder access and modification

Calendar

• Event creation and management
• Advanced calendar search capabilities
• Meeting and appointment scheduling
• Direct calendar event access

Maps

• Location search and discovery
• Favorite location management
• Route planning and navigation
• Location guide creation and pin management

Installation

Option 1: Smithery Integration

npx -y install-mcp apple-mcp --client claude

For Cursor IDE users:

npx -y install-mcp apple-mcp --client cursor

Option 2: Manual Configuration

brew install oven-sh/bun/bun

Add to your claude_desktop_config.json:

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

Usage Examples

"Send a message to John regarding the delayed dinner arrival"
"Search notes for 'AI research' and display results"
"Create a reminder for dental appointment tomorrow at 2:00 PM"
"Display calendar events for next week"
"Locate nearest coffee establishment and add to favorites"

Development Setup

git clone https://github.com/Ayaanisthebest/appleMCP.git
cd appleMCP
bun install
bun run index.ts

Acknowledgments

Original Development Team

This project builds upon the foundation established by the supermemoryai/apple-mcp development team:

• @Dhravya - Project founder and principal developer
• @jxnl - Core architecture and development
• @calclavia - Development and testing
• The complete supermemory team for ongoing project support

Enhancement Development

Additional features and improvements developed by @Ayaanisthebest

License

This project is licensed under the MIT License. See the LICENSE file for complete license terms.

---

For additional information about the original project, visit: https://mcp.supermemory.ai