📌Overview

Purpose: Provide a Model Context Protocol (MCP) server for seamless integration with Apple Reminders on macOS.

Overview: This framework enables users to interact with Apple Reminders through a standardized interface. Built for macOS, the server allows for comprehensive management of reminders, facilitating tasks such as creation, listing, and modification with ease.

Key Features:

List Reminders: Retrieve all reminders or specific reminder lists, enhancing organization and accessibility.
Create Reminders: Effortlessly add new reminders with titles, notes, and due dates, streamlining task management.
Manage Reminders: Mark reminders as complete or incomplete, providing flexibility in task tracking.

Apple Reminders MCP Server

A Model Context Protocol (MCP) server that provides native integration with Apple Reminders on macOS. This server allows you to interact with Apple Reminders through a standardized interface.

Features

List all reminders and reminder lists
Create new reminders with titles and optional details
Mark reminders as complete/incomplete
Add notes to reminders
Set due dates for reminders
Native macOS integration

Prerequisites

Node.js 18 or later
macOS (required for Apple Reminders integration)
Xcode Command Line Tools (required for compiling Swift code)

Quick Start

Install globally via npm:

npm install -g mcp-server-apple-reminders

Configuration

Configure Cursor

Open Cursor
Open Cursor settings
Click on MCP in the sidebar
Click Add new global MCP server
Configure the server with the following settings:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "mcp-server-apple-reminders",
      "args": []
    }
  }
}

Configure ChatWise

Open ChatWise
Go to Settings
Navigate to the Tools section
Click the "+" button
Configure the tool with the following settings:
- Type: stdio
- ID: apple-reminders
- Command: mcp-server-apple-reminders
- Args: (leave empty)

Configure Claude Desktop

You need to configure Claude Desktop to recognize the Apple Reminders MCP server. You can access the configuration via:

Option 1: Through Claude Desktop UI
1. Open Claude Desktop app
2. Enable Developer Mode from the top-left menu bar
3. Open Settings and navigate to the Developer Option
4. Click Edit Config to open claude_desktop_config.json
Option 2: Direct File Access

For macOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add Server Configuration

Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "mcp-server-apple-reminders",
      "args": []
    }
  }
}

Restart Claude Desktop

Completely quit Claude Desktop (not just close the window)
Start Claude Desktop again
Verify the Apple Reminders server connection by looking for the tool icon

Usage Examples

After configuration, you can ask Claude to interact with your Apple Reminders.

Creating Reminders

Create a reminder to "Buy groceries" for tomorrow at 5 PM.
Add a reminder to "Call mom" with a note "Ask about weekend plans".
Create a reminder in my "Work" list to "Submit report" due next Friday.

Managing Reminders

Show me all my reminders.
List all reminders in my "Shopping" list.
Show my completed reminders.

Working with Lists

Show all my reminder lists.
Show reminders from my "Work" list.

The server will process your natural language requests, interact with Apple’s native Reminders app, and return formatted results.

Available MCP Tools

Create Reminder

create_reminder(title: string, dueDate?: string, list?: string, note?: string)

Creates a new reminder with the specified title and optional parameters:

title: Title of the reminder (required)
dueDate: Optional due date in format 'YYYY-MM-DD HH:mm:ss' (e.g., '2025-03-12 10:00:00')
list: Optional name of the reminders list to add to
note: Optional note text to attach to the reminder

Example response:

{
  "content": [
    {
      "type": "text",
      "text": "Successfully created reminder: Buy groceries with notes"
    }
  ],
  "isError": false
}

List Reminders

list_reminders(list?: string, showCompleted?: boolean)

Lists all reminders or reminders from a specific list:

list: Optional name of the reminders list to show
showCompleted: Whether to show completed reminders (default: false)

Example response:

{
  "reminders": [
    {
      "title": "Buy groceries",
      "list": "Shopping",
      "isCompleted": false,
      "dueDate": "2024-03-25 18:00:00",
      "notes": "Don't forget milk"
    }
  ],
  "total": 1,
  "filter": {
    "list": "Shopping",
    "showCompleted": false
  }
}

List Reminder Lists

list_reminder_lists()

Returns a list of all available reminder lists.

Example response:

{
  "lists": [
    {
      "id": 1,
      "title": "Shopping"
    },
    {
      "id": 2,
      "title": "Work"
    }
  ],
  "total": 2
}

Development

Install dependencies:

npm install

Build the Swift binary for Apple Reminders integration:

npm run build:swift

Build the TypeScript code:

npm run build:ts

Project Structure

.
├── src/                   # Source code directory
│   ├── index.ts           # Main entry point
│   ├── server/            # MCP server implementation
│   ├── swift/             # Native Swift integration code
│   │   ├── bin/           # Compiled Swift binaries
│   │   └── src/           # Swift source files
│   ├── tools/             # CLI tools and utilities
│   ├── types/             # TypeScript type definitions
│   └── utils/             # Helper functions and utilities
├── dist/                  # Compiled JavaScript output
├── node_modules/          # Node.js dependencies
└── tests/                 # Test files and test utilities

Available Scripts

npm run build:ts - Build TypeScript code
npm run build:swift - Build Swift binary
npm run dev - Run TypeScript compiler in watch mode
npm run start - Start the MCP server
npm test - Run tests