reminder-manager

Reminder Manager

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

CLI Usage

Run the Swift source directly (no build step required):

swift ${CLAUDE_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 ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders lists

Operations

List All Reminder Lists

swift ${CLAUDE_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 ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders today

Get Incomplete Reminders

All incomplete reminders:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders incomplete

From a specific list:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders incomplete "Tasks"

Get Overdue Reminders

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders overdue

Create a Reminder

Basic reminder:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders create \
  --title "Buy groceries" \
  --list "Tasks"

With due date:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders create \
  --title "Submit report" \
  --list "Work" \
  --due "2025-01-15 17:00"

With priority:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders create \
  --title "Urgent task" \
  --list "Work" \
  --priority 1

With notes:

swift ${CLAUDE_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 ${CLAUDE_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 ${CLAUDE_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 ${CLAUDE_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 ${CLAUDE_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 ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders complete --title "Buy groceries"

With specific list:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders complete --title "Buy groceries" --list "Tasks"

Mark Reminder as Incomplete

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders uncomplete --title "Buy groceries"

With specific list:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders uncomplete --title "Buy groceries" --list "Tasks"

Delete a Reminder

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders delete --title "Buy groceries"

With specific list:

swift ${CLAUDE_PLUGIN_ROOT}/scripts/productivity-cli.swift reminders delete --title "Buy groceries" --list "Tasks"

Create a New Reminder List

swift ${CLAUDE_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