apple-remind-me

Apple Remind Me (macOS Native)

Create, manage, and organize Apple Reminders using natural language. Works with Reminders.app natively - syncs to iPhone, iPad, Apple Watch.

Quick Reference

Want to...	Command	Example
Create reminder	create-reminder.sh "msg" "when"	create-reminder.sh "Call mom" "tomorrow at 2pm"
List reminders	list-reminders.sh [filter]	list-reminders.sh today
Complete reminder	complete-reminder.sh ID	complete-reminder.sh XXXX-XXXX
Delete reminder	delete-reminder.sh ID	delete-reminder.sh XXXX-XXXX
Edit message	edit-reminder-message.sh ID "msg"	edit-reminder-message.sh XXXX "New text"
Edit time	edit-reminder-time.sh ID "when"	edit-reminder-time.sh XXXX "next friday"

Available Commands

1. Create Reminder

Create a new reminder with natural language time parsing.

Usage:

./create-reminder.sh "message" "when"

Examples:

./create-reminder.sh "Pay bills" "later today"
./create-reminder.sh "Call dentist" "tomorrow at 3pm"
./create-reminder.sh "Check email" "in 2 hours"
./create-reminder.sh "Team meeting" "next monday at 10am"

2. List Reminders

Display all incomplete reminders with IDs, titles, due dates, and lists.

Usage:

./list-reminders.sh

Output Format:

⏳ ID: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
   Title: Reminder text
   Due: 2026-01-27 14:00
   List: Reminders

3. Complete Reminder

Mark a reminder as completed (it will move to completed list in Reminders.app).

Usage:

./complete-reminder.sh "REMINDER-ID"

Example:

./complete-reminder.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09"

4. Delete Reminder

Permanently delete a reminder.

Usage:

./delete-reminder.sh "REMINDER-ID"

Example:

./delete-reminder.sh "7C403BC5-6016-410A-810D-9A0F924682F9"

5. Edit Reminder Message

Update the text/title of an existing reminder.

Usage:

./edit-reminder-message.sh "REMINDER-ID" "new message"

Example:

./edit-reminder-message.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "Updated reminder text"

6. Edit Reminder Time

Reschedule a reminder to a new time using natural language.

Usage:

./edit-reminder-time.sh "REMINDER-ID" "new time"

Examples:

./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "tomorrow at 2pm"
./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "in 3 hours"
./edit-reminder-time.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09" "next friday"

Time Parsing Reference

Relative Times

Format: in [number] [unit]

• in 5 minutes → 5 minutes from now
• in 2 hours → 2 hours from now
• in 3 days → 3 days from now at current time

Time of Day Shortcuts

• later today / later / this afternoon → Today at 17:00
• tonight → Today at 20:00
• tomorrow → Tomorrow at 09:00

Tomorrow with Specific Time

Format: tomorrow at [time]

• tomorrow at 3pm → Tomorrow at 15:00
• tomorrow at 10:30am → Tomorrow at 10:30
• tomorrow at 8pm → Tomorrow at 20:00

Day of Week

Format: next [weekday] (lowercase required)

• next monday → Next Monday at 09:00
• next friday → Next Friday at 09:00
• next sunday → Next Sunday at 09:00

Note: Day names must be lowercase (monday, tuesday, etc.)

ISO Format (fallback)

• 2026-01-27 14:00 → Exact date and time

Agent Implementation Guide

Creating Reminders

When user says: "Remind me to X at/in Y"

./create-reminder.sh "X" "Y"

Listing Reminders

When user asks: "What are my reminders?" or "Show my reminders"

./list-reminders.sh

Completing Reminders

When user says: "Mark [reminder] as done" or "Complete [reminder]"

1. List reminders to find the ID
2. Use the ID to complete:

./complete-reminder.sh "REMINDER-ID"

Editing Reminders

When user says: "Change [reminder] to say X" or "Reschedule [reminder] to Y"

1. List reminders to find the ID
2. Edit message or time:

./edit-reminder-message.sh "REMINDER-ID" "new message"
./edit-reminder-time.sh "REMINDER-ID" "new time"

Deleting Reminders

When user says: "Delete [reminder]" or "Remove [reminder]"

1. List reminders to find the ID
2. Delete:

./delete-reminder.sh "REMINDER-ID"

Workflow Examples

Complete Workflow: Find and Complete a Reminder

# 1. List all reminders
./list-reminders.sh | grep "Pay bills"

# 2. Get the ID from output
# Output shows: ID: CDCBCB94-1215-494E-9F12-471AFEF25C09

# 3. Mark as complete
./complete-reminder.sh "CDCBCB94-1215-494E-9F12-471AFEF25C09"

Complete Workflow: Reschedule a Reminder

# 1. List reminders and find the one to reschedule
./list-reminders.sh | grep "Team meeting"

# 2. Reschedule to new time
./edit-reminder-time.sh "REMINDER-ID" "next friday at 2pm"

Technical Details

• Backend: Uses remindctl command-line tool (macOS native)
• Date Parsing: BSD date utility (macOS compatible)
• Time Format: ISO 8601 timestamps for remindctl
• List Filtering: Shows only incomplete reminders by default
• Sync: All changes sync immediately to iCloud and all devices

Requirements

• macOS (darwin)
• remindctl (installed at /usr/local/bin/remindctl)
• date (BSD version, macOS default)
• python3 (for JSON parsing in list-reminders.sh)
• Apple Reminders.app

Limitations

• Day of week parsing requires lowercase (e.g., "monday" not "Monday")
• "Next [weekday]" adds 7 days (doesn't calculate exact next occurrence)
• No support for recurring reminders
• No support for custom reminder lists (uses default "Reminders" list)
• No location-based reminders