reminder-manager

name	reminder-manager
description	Use when creating, completing, listing, or deleting macOS Reminders — setting due dates, priorities, notes, or recurrence, checking pending or overdue tasks, or managing reminder lists via the bundled EventKit CLI. Requires macOS with Reminders access.

Reminder Manager

Manage macOS Reminders using the productivity-cli tool (EventKit-based).

CLI Usage

Run the Swift source directly (no build step required). <plugin-root> is the installed plugin directory — the directory that contains scripts/ and codex-skills/ (two levels above this skill's folder; in a repository checkout it is productivity-skills/). Resolve it to an absolute path and substitute it in every command:

swift <plugin-root>/scripts/productivity-cli.swift <command>

Requires: macOS 13+ with Xcode command line tools installed.

Important: Always Ask for Reminder List

Before any create operation, list reminder lists and ask the user which one to use:

swift <plugin-root>/scripts/productivity-cli.swift reminders lists

Operations

List All Reminder Lists

swift <plugin-root>/scripts/productivity-cli.swift reminders lists

Returns JSON:

{
  "success": true,
  "count": 3,
  "data": [
    {"name": "Tasks", "count": 5},
    {"name": "Work", "count": 2},
    {"name": "Personal", "count": 0}
  ]
}

The count field shows incomplete reminders in each list.

Get Reminders Due Today

swift <plugin-root>/scripts/productivity-cli.swift reminders today

Get Incomplete Reminders

All incomplete reminders:

swift <plugin-root>/scripts/productivity-cli.swift reminders incomplete

From a specific list:

swift <plugin-root>/scripts/productivity-cli.swift reminders incomplete "Tasks"

Get Overdue Reminders

swift <plugin-root>/scripts/productivity-cli.swift reminders overdue

Create a Reminder

Basic reminder:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Buy groceries" \
  --list "Tasks"

With due date:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Submit report" \
  --list "Work" \
  --due "2025-01-15 17:00"

With priority:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Urgent task" \
  --list "Work" \
  --priority 1

With notes:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Call John" \
  --list "Tasks" \
  --notes "Discuss project timeline and budget"

Full reminder with all properties:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Team meeting prep" \
  --list "Work" \
  --due "2025-01-15 09:00" \
  --priority 1 \
  --notes "Prepare slides and agenda"

Create a Recurring Reminder

Daily medication reminder:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Take medication" \
  --list "Health" \
  --due "2026-01-20 08:00" \
  --repeat daily

Weekly grocery shopping:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Grocery shopping" \
  --list "Personal" \
  --due "2026-01-25 10:00" \
  --repeat weekly

Bi-weekly task:

swift <plugin-root>/scripts/productivity-cli.swift reminders create \
  --title "Review expenses" \
  --list "Work" \
  --due "2026-01-20 17:00" \
  --repeat weekly \
  --repeat-interval 2

Mark Reminder as Complete

swift <plugin-root>/scripts/productivity-cli.swift reminders complete --title "Buy groceries"

With specific list:

swift <plugin-root>/scripts/productivity-cli.swift reminders complete --title "Buy groceries" --list "Tasks"

Mark Reminder as Incomplete

swift <plugin-root>/scripts/productivity-cli.swift reminders uncomplete --title "Buy groceries"

With specific list:

swift <plugin-root>/scripts/productivity-cli.swift reminders uncomplete --title "Buy groceries" --list "Tasks"

Delete a Reminder

swift <plugin-root>/scripts/productivity-cli.swift reminders delete --title "Buy groceries"

With specific list:

swift <plugin-root>/scripts/productivity-cli.swift reminders delete --title "Buy groceries" --list "Tasks"

Create a New Reminder List

swift <plugin-root>/scripts/productivity-cli.swift reminders create-list "Shopping"

Response Format

All commands return JSON. Success responses:

{
  "success": true,
  "count": 5,
  "data": [
    {
      "title": "Buy groceries",
      "list": "Tasks",
      "dueDate": "2025-01-15 17:00:00",
      "priority": 0,
      "isCompleted": false,
      "notes": null,
      "isRecurring": false,
      "recurrence": null
    }
  ]
}

Recurring reminder response:

{
  "title": "Take medication",
  "list": "Health",
  "dueDate": "2026-01-20 08:00:00",
  "priority": 0,
  "isCompleted": false,
  "notes": null,
  "isRecurring": true,
  "recurrence": {
    "frequency": "daily",
    "interval": 1,
    "endDate": null,
    "occurrenceCount": null,
    "daysOfWeek": null
  }
}

Action results:

{
  "success": true,
  "message": "Reminder 'Buy groceries' created successfully"
}

Error responses:

{
  "error": "Reminder list 'Unknown' not found"
}

Priority Values

Value	Meaning	Display
0	No priority	(none)
1	High	!!!
5	Medium	!!
9	Low	!

Date Format

Use yyyy-MM-dd HH:mm for due dates:

• 2025-01-15 17:00 - January 15, 2025 at 5:00 PM
• 2025-01-15 09:00 - January 15, 2025 at 9:00 AM

Reminder Properties

Argument	Required	Description
--title	Yes	Reminder title
--list	Yes (create)	Reminder list name
--due	No	Due date/time
--priority	No	Priority (0, 1, 5, or 9)
--notes	No	Notes/description
--repeat	No	Recurrence frequency: daily, weekly, monthly, yearly
--repeat-interval	No	Every N periods (default: 1)

Limitations

• Tags are not supported
• Location-based reminders cannot be created
• Subtasks are not accessible
• Attachments cannot be added

Notes

• Always list reminder lists first and confirm with user before create
• List names are case-insensitive
• The CLI uses EventKit for fast, native access to Reminders data
• Searching by title finds the first matching reminder