Reminders

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.

meleantonio 4a3ec26 2 files · 5.9 KB Updated

File contents

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.

meleantonio/cursorericbuild/tree/main/workstation/.cursor/skills/reminders commit 4a3ec26347

Frequently asked questions

npx skillmds@latest add meleantonio/reminders