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
- 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