Applemcp

🚀 Apple MCP - Enhanced Edition

This enhanced version of Apple MCP extends the original project with additional features and improvements, enabling AI assistants to better interact with native Apple applications.

🚀 Quick Start

This enhanced version of Apple MCP extends the original supermemoryai/apple-mcp repository. It offers a comprehensive Model Context Protocol server for Apple ecosystem integration, allowing AI assistants to interact with native Apple applications more effectively.

✨ Features

Smart Contact Resolution

• Automatically resolves contact names to phone numbers in the Messages tool.
• Eliminates the need for manual contact lookup before messaging.
• Parses phone numbers intelligently, with a preference for international formats.

Enhanced Notes Management

• Uses a priority-based search algorithm that prioritizes title matches over content.
• Provides visual indicators for search result types (Title Match vs Content Match).
• Fully supports Apple Notes' rich text formatting and structure.
• Offers advanced note editing capabilities while preserving the format.

Improved Error Handling

• Enhances validation and provides user-friendly error messaging.
• Offers comprehensive error guidance and troubleshooting.
• Has advanced debugging and logging capabilities.

Developer Experience Improvements

• Enhances TypeScript interfaces and type validation.
• Improves code organization and maintainability.
• Provides comprehensive debugging and development tools.

🔧 Technical Details

Core Functionality

Messages

• Sends messages using contact names with automatic phone number resolution.
• Accesses message history and conversation threads.
• Schedules messages for future delivery.
• Enhances error handling and validation.

Notes

• Conducts advanced searches with priority-based result ranking.
• Creates and edits rich text with full formatting support.
• Organizes notes and manages folders.
• Modifies content while preserving formatting.

Contacts

• Searches for and retrieves contacts comprehensively.
• Manages phone numbers and email addresses.
• Is a required integration step for messaging operations.

Mail

• Composes emails with attachment, CC, and BCC support.
• Searches for and filters emails advancedly.
• Schedules email delivery.
• Monitors unread messages.

Reminders

• Creates tasks with due date management.
• Searches for and organizes reminders advancedly.
• Lists and manages reminders comprehensively.
• Accesses and modifies reminders directly.

Calendar

• Creates and manages events.
• Has advanced calendar search capabilities.
• Schedules meetings and appointments.
• Accesses calendar events directly.

Maps

• Searches for and discovers locations.
• Manages favorite locations.
• Plans routes and navigates.
• Creates location guides and manages pins.

📦 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

Basic Usage

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

📚 Documentation

Development Setup

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

Acknowledgments

Original Development Team

This project is based on the work of 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 are 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