apple_reminder_mcp_server

This MCP server exposes a set of tools that let you interact with the macOS Apple Reminders app from AI agents or other MCP clients. It relies on Python and AppleScript to create, read, list, and delete reminders, enabling automation workflows from Claude Desktop or any MCP-enabled client. The available tools focus on common reminder operations: creating reminders (with optional due dates, times, notes, and locations), listing all reminder lists, fetching reminders from a specific list (with an option to filter completed ones), and deleting reminders by name. When you connect via the MCP inspector, you’ll see a session token and a proxy interface that helps you test and explore the endpoints before integrating with your assistant.

Prerequisites:

• macOS (required for AppleScript integration)
• Python 3.10 or higher
• Apple Reminders app

Installation steps:

1. Install the package from PyPI (recommended):

   pip install apple-reminders-mcp
   

2. Run the server (example if installed via pip):

   apple-reminders-mcp
   

   Alternatively, run directly with Python if you prefer:

   python -m apple_reminders_mcp.server
   

3. (Optional) Install from source:

   git clone https://github.com/shreyanshjain05/apple_reminder_mcp_server.git
   cd apple_reminder_mcp_server
   pip install -e .
   

4. Verify the server is running by connecting through the MCP inspector or your client. The default setup exposes the MCP interface described in the README.

Note: If you encounter path or environment issues, ensure your Python executable is accessible (e.g., use the full path to python3 in your environment) and that AppleScript permissions are granted for automation in System Settings.

Tips and common considerations:

• macOS AppleScript requires UI scripting permissions. If you see permission errors, grant Terminal or your IDE automation access in System Preferences > Security & Privacy > Automation.
• To test integrations, use the MCP Inspector to start a proxy at localhost:6277 and view the inspector UI at localhost:6274, as described in the README.
• If a list name or reminder name contains special characters or spaces, ensure you provide exact matching strings as Apple Reminders is case-sensitive for list names.
• When integrating with Claude Desktop, point the config to the Python invocation and the server module as shown in the examples, and prefer full paths if you run into runtime path issues.
• Environment variables are not strictly required for basic operation, but you can customize paths or Python environments if you manage multiple Python versions.