MCP Server Apple Reminders

🚀 Apple Reminders MCP Server

English | Simplified Chinese

An MCP server that provides native integration with Apple Reminders on macOS. Through this server, users can interact with reminders via standardized interfaces.

✨ Features

• List all reminders and reminder lists: Users can view all reminders and the lists they belong to.
• Create new reminders: Support adding new reminders, with customizable titles, lists, completion status, due dates, and notes.
• Mark reminders as completed or incomplete: Allow users to update the completion status of specific reminders.
• Add notes: Users can add additional information notes to reminders for more detailed task records.
• Set due dates: Set specific due times for each reminder to help users better manage task priorities.
• Native macOS integration: Achieved through local integration in Swift, ensuring high compatibility and performance optimization with Apple Reminders service.

📦 Prerequisites

1. Operating system: macOS (due to the project's reliance on Apple's Reminders service).
2. Node.js version: Node.js 18 or higher to ensure support for the latest features and security.
3. Development tools: Xcode command-line tools for compiling and building Swift code.

📦 Installation

npm install -g mcp-server-apple-reminders

📚 Configuration Guide

Configuration in Cursor

1. Open Cursor's settings interface.
2. Navigate to the plugin management section.
3. Add a new MCP server configuration, specifying the server address and port.
4. Enable the Apple Reminders integration option.

Configuration in ChatWise

1. Go to ChatWise's preference settings menu.
2. Select the Plugins & Extensions tab.
3. Add a new MCP service entry and fill in the corresponding server information.
4. Start the Apple Reminders synchronization function.

Configuration in Claude Desktop

Method 1: Edit the configuration file directly

1. Open the Terminal application.
2. Enter the following command to access the configuration file in the user directory:

   cd ~/Library/Application\ Support/Claude/
   

3. Edit the config.json file and add the following content:

   "mcpServers": {
     "appleRemindersServer": {
       "url": "http://localhost:8080",
       "enabled": true
     }
   }
   

Method 2: Configure through the graphical interface

1. Open Claude Desktop's settings window.
2. Select the Plugin Management tab.
3. Click the "Add New Server" button and enter the relevant information for the Apple Reminders MCP server.
4. Save the settings after completion.

💻 Usage Examples

Create a reminder

# Example: Create a new shopping reminder
{
  "command": "create_reminder",
  "title": "Buy groceries",
  "list": "Family",
  "duedate": "2024-03-25T18:00:00Z",
  "notes": "Don't forget to buy milk"
}

Query reminders

# Example: List incomplete reminders in a specified list
{
  "command": "list_reminders",
  "filter": {
    "list": "Work",
    "showCompleted": false
  }
}

Update reminder status

# Example: Mark a specific reminder as completed
{
  "command": "update_reminder_status", 
  "reminderId": 123,
  "completed": true
}

🔧 Development Steps

1. Install dependencies:

   npm install
   

2. Build the Swift executable (for native Apple Reminders integration):

   npm run build:swift
   

3. Compile TypeScript code:

   npm run build:ts
   

4. Start the development server:

   npm run start
   

📁 Project Structure

.
├── src/                   # Source code directory
│   ├── index.ts           # Main entry point of the application
│   ├── server/            # MCP server implementation
│   ├── swift/             # Native Swift integration code
│   │   ├── bin/           # Compiled Swift executables
│   │   └── src/           # Swift source code files
│   ├── tools/             # CLI tools and auxiliary scripts
│   ├── types/             # TypeScript type definitions
│   └── utils/             # Helper functions and utility modules
├── dist/                  # Compiled output directory (for production)
└── package.json           # Project dependency management file

⚠️ Important Note

• Permissions: On macOS, ensure that the application has permission to access the Apple Reminders service. You may need to authorize it in the system preferences.
• Compatibility: It is recommended to test on different macOS versions to verify the compatibility of the plugin.
• Data synchronization: Since the local reminder database is directly manipulated, there may be data synchronization issues with other clients (such as iCloud). Please ensure manual synchronization regularly.

🤝 Contribution Guide

Contributions to the code, as well as questions and suggestions, are welcome. Please refer to the CONTRIBUTING.md file in the project repository for specific collaboration processes and guidelines.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

By following the above steps and configurations, you can successfully integrate the Apple Reminders service with the MCP server on macOS, thereby enhancing task management efficiency.