# 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.

- Skill: `meleantonio/reminders` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add meleantonio/reminders`
- Raw SKILL.md: https://api.skillmd.com/api/skills/meleantonio/reminders/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: meleantonio (https://skillmd.com/u/meleantonio)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/meleantonio/reminders

---


# 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:

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

Create with due time:

```bash
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:

```bash
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.