reminders

name	reminders
description	Creates, lists, and completes items in macOS Reminders.app via AppleScript. Use when capturing todos, listing open tasks, or marking reminders done from a self-hosted macOS agent.

Reminders

When to use

• Create a reminder with optional due date and notes.
• List non-completed/completed tasks in a list.
• Complete a reminder matching a name substring.

Prerequisites

• Automation permission for the agent to control Reminders.

Script (from workstation/ root)

List default list:

python3 workstation/.cursor/skills/reminders/scripts/reminders_ops.py list --list-name Reminders

Create with due time:

python3 workstation/.cursor/skills/reminders/scripts/reminders_ops.py create \
  --list-name Reminders \
  --title "Call dentist" \
  --due "2026-04-03T09:00:00"

Complete first reminder whose name contains text:

python3 workstation/.cursor/skills/reminders/scripts/reminders_ops.py complete \
  --list-name Reminders \
  --match "dentist"

Output

JSON with ok and either reminders (for list) or detail (for create/complete).

Notes

• List names must match exactly (default macOS list is often Reminders).
• complete matches the first reminder containing --match — use specific substrings.