mcpField
R
reminders

reminders

github.com/steipeteProductivity7.4k88 installsUpdated 1w ago
Repository

About reminders

Reminders is a skill for managing Apple Reminders through the `rem` CLI, intended for personal task workflows on macOS. It covers task and list operations, JSON-based checks, due dates, priorities, notes, and repeat schedules.

Key features

  1. 01Read and search reminders
  2. 02Add tasks with dates and priorities
  3. 03Update, complete, and delete tasks
  4. 04Create and manage lists
  5. 05Verify changes with JSON output

Use cases

  1. 01Recording a task with a due date
  2. 02Finding incomplete or matching reminders
  3. 03Organizing tasks into named lists

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steipete/agent-scripts --skill reminders

After installing, type/remindersin Claude Code to confirm it loaded.

Details

From the project README

Reminders

Use this for Apple Reminders tasks. Prefer rem over Things/AppleScript when the user wants an AI-friendly personal todo backend on macOS.

Tool

  • CLI: rem
  • Repo: https://github.com/BRO3886/rem
  • Install:
GOBIN=/opt/homebrew/bin go install github.com/BRO3886/rem/cmd/rem@latest

rem uses EventKit for normal reads/writes. It may need Reminders permission for the calling app in System Settings > Privacy & Security.

Start

Check access:

rem lists -o json
rem today -o json

Use JSON for anything scripted or verified:

rem list --incomplete -o json
rem search "flight" -o json
rem show <id> -o json

Add Tasks

Default: add directly, then verify by search/show.

rem add "Book LHR-SFO nonstop business flight" --due "tomorrow 9am" --priority high --notes "Nonstop only." -o json
rem search "LHR-SFO" -o json

Useful flags:

  • --list "Name": target list
  • --due "tomorrow 9am": due date/time; natural language is supported
  • --priority high|medium|low|none
  • --notes "text"
  • --url https://...
  • --silent: due date without notification
  • --remind-me 15m: alarm before due time
  • --repeat daily|weekly|monthly|yearly

Update / Complete / Delete

Find the UUID first, then mutate by id or unique short id:

rem search "flight" -o json
rem update <id> --name "New title" --due "friday 2pm" --notes "..." -o json
rem complete <id> -o json
rem delete <id> --force

Always read back after writes; do not trust exit status alone.

Lists

rem lists --count -o json
rem list-mgmt create "Travel"
rem list-mgmt rename "Old" "New"
rem list-mgmt delete "Name" --force

Conventions

  • Use executable task titles. Rewrite vague notes into the next concrete action.
  • Preserve user wording when they clearly want verbatim capture.
  • Split multiple unrelated actions into separate reminders.
  • Use the default list unless the user names a list or the category is obvious.
  • Do not add calendar events here; use calendar tooling instead.
  • For current date math, run date; do not guess.

Gotchas

  • macOS only.
  • First run may fail with reminders access denied until the calling app has Reminders permission.
  • The default local list may be localized, e.g. Erinnerungen.
  • rem search is plain query search, not shell regex.
  • --due creates an alarm at the due time unless --silent is passed.
  • Flagged reminders use private ReminderKit under the hood and may be more OS fragile than ordinary CRUD.

Comments

Markdown supported