--- name: mac-reminders-agent version: 1.4.0 author: swancho license: MIT description: | Integrate with macOS Reminders app to check, add, edit, delete, and complete reminders. Supports multiple reminder lists (calendars), priority levels (high/medium/low), and title search. Supports native recurrence (매주/weekly/毎週/每周) via Swift EventKit - creates single reminder with repeat rule. Supports editing and deleting reminders by ID (calendarItemIdentifier from EventKit). Supports multiple languages (en, ko, ja, zh) for trigger detection and response formatting. When users request recurring reminders, MUST use --repeat option (daily|weekly|monthly|yearly). Supports parsing meeting notes to extract action items and suggest reminders (parse command). Parse command is pure text processing - no Reminders app access required. requirements: runtime: - node >= 18.0.0 - npm - macOS with Xcode Command Line Tools (includes Swift compiler) permissions: - macOS Reminders access (system prompt on first use) repository: https://github.com/swancho/mac-reminders-agent install: | cd $SKILL_DIR && npm install ---

Mac Reminders Agent

Overview

This skill integrates with the local macOS Reminders app to:

• View and organize today's/this week's reminders (with unique IDs)
• Multiple lists: View all reminder lists, filter/add to specific lists
• Priority: Set and view priority levels (high/medium/low)
• Search: Find reminders by title keyword
• Add new reminders based on natural language requests
• Edit reminders: Modify title, due date, notes, priority by ID
• Delete reminders: Remove reminders by ID
• Complete reminders: Mark reminders as done by ID
• Native recurrence: Weekly, daily, monthly, yearly repeating reminders
• Parse meeting notes: Extract action items from text and suggest reminders
• Multi-language support: English, Korean, Japanese, Chinese

The skill uses the following files relative to its directory:

• cli.js (unified entry point)
• reminders/apple-bridge.js (backend: AppleScript + applescript npm module)
• reminders/eventkit-bridge.swift (native recurrence via Swift EventKit)
• reminders/meeting-parser.js (meeting notes parser for action item extraction)
• locales.json (language-specific triggers and responses)

Language Support

The skill automatically detects user language or can be explicitly set via --locale parameter.

Supported Languages

| Code | Language | Example Trigger | |------|----------|-----------------| | en | English | "What do I have to do today?" | | ko | 한국어 | "오늘 할 일 뭐 있어?" | | ja | 日本語 | "今日のタスクは？" | | zh | 中文 | "今天有什么任务？" |

Language Detection

1. Explicit: Use --locale parameter
2. Automatic: Detect from user's message language
3. Default: Falls back to en (English)

---

How It Works

User natural language requests are handled in two cases:

1. List reminders (list)
2. Add reminder (add)

For each case, call the Node.js CLI, receive JSON results, and format them using locale-specific templates.

---

0) View Reminder Lists

Command Invocation

node skills/mac-reminders-agent/cli.js lists --locale ko

Output Format

Returns JSON with calendars array:

{
  "calendars": [
    { "id": "cal-id-1", "name": "Reminders", "isDefault": true },
    { "id": "cal-id-2", "name": "Work", "isDefault": false }
  ]
}

---

1) List Reminders

Trigger Examples (by language)

English:

• "What do I have to do today?"
• "Show me today's reminders"
• "What's on my schedule this week?"

Korean (한국어):

• "오늘 할 일 뭐 있어?"
• "오늘 미리알림 정리해줘"
• "이번 주 일정 뭐 있어?"

Japanese (日本語):

• "今日のタスクは？"
• "今日のリマインダーを見せて"

Chinese (中文):

• "今天有什么任务？"
• "显示今天的提醒"

Command Invocation

# List with default locale (en)
node skills/mac-reminders-agent/cli.js list --scope today

# List with specific locale
node skills/mac-reminders-agent/cli.js list --scope week --locale ko

# List from specific list
node skills/mac-reminders-agent/cli.js list --scope week --list "Work"

# Search by title keyword
node skills/mac-reminders-agent/cli.js list --query "meeting" --scope all

Parameters

• --scope (optional): today, week (default), all
• --list (optional): Filter by reminder list name (omit for all lists)
• --query (optional): Filter by title keyword (case-insensitive)
• --locale (optional): Response language (en, ko, ja, zh)

Output Format

Returns JSON with items array:

[
  {
    "id": "ABC-123-DEF",
    "title": "Task title",
    "due": "2026-02-05T16:30:00+09:00",
    "list": "Work",
    "priority": "high",
    "completed": false
  }
]

Response Formatting

Use locales.json templates to format responses in user's language:

English:

[Incomplete Reminders]
- 2/2 (Mon) 09:00 [Work] Meeting
- 2/3 (Tue) 14:00 [Personal] Visit bank

[Completed]
- 2/1 (Sun) [Work] Submit report ✅

Korean:

[미완료 미리알림]
- 2/2 (월) 09:00 [업무] 회의
- 2/3 (화) 14:00 [개인] 은행 방문

[완료됨]
- 2/1 (일) [업무] 보고서 제출 ✅

---

2) Add Reminder

Trigger Examples (by language)

English:

• "Add a meeting reminder for 9am tomorrow"
• "Set a reminder to submit report by Friday"

Korean (한국어):

• "내일 아침 9시에 회의 미리알림 추가해줘"
• "이번 주 금요일까지 보고서 제출 미리알림 넣어줘"

Japanese (日本語):

• "明日の朝9時に会議のリマインダーを追加して"

Chinese (中文):

• "添加明天早上9点的会议提醒"

Command Invocation

# Add with locale
node skills/mac-reminders-agent/cli.js add --title "Meeting" --due "2026-02-05T09:00:00+09:00" --locale ko

# Add with priority and specific list
node skills/mac-reminders-agent/cli.js add --title "Urgent Report" --due "2026-02-05T17:00:00+09:00" --priority high --list "Work" --locale ko

Parameters

• --title (required): Reminder title
• --due (optional): ISO 8601 format (YYYY-MM-DDTHH:mm:ss+09:00)
• --note (optional): Additional notes
• --priority (optional): high, medium, low, none (default: none)
• --list (optional): Target reminder list name (default: system default list)
• --locale (optional): Response language (en, ko, ja, zh)

Response Examples

English:

• "Added 'Meeting' reminder for 9am tomorrow."
• "Added 'Submit report' reminder without a due date."

Korean:

• "'회의' 미리알림을 추가했어요 (내일 오전 9시)."
• "'보고서 제출' 미리알림을 추가했어요 (마감일 없음)."

---

3) Edit Reminder

Trigger Examples (by language)

English:

• "Change the meeting reminder to 10am"
• "Update the report deadline to next Monday"

Korean (한국어):

• "회의 미리알림 10시로 바꿔줘"
• "보고서 마감일 다음 주 월요일로 수정해줘"

Command Invocation

# Edit title
node skills/mac-reminders-agent/cli.js edit --id "ABC123" --title "New Meeting Title" --locale ko

# Edit due date
node skills/mac-reminders-agent/cli.js edit --id "ABC123" --due "2026-03-01T10:00:00+09:00"

# Edit priority
node skills/mac-reminders-agent/cli.js edit --id "ABC123" --priority high

# Edit note
node skills/mac-reminders-agent/cli.js edit --id "ABC123" --note "Updated notes"

Parameters

• --id (required): Reminder ID (calendarItemIdentifier from list output)
• --title (optional): New title
• --due (optional): New due date in ISO 8601 format
• --note (optional): New note text
• --priority (optional): high, medium, low, none
• --locale (optional): Response language (en, ko, ja, zh)

IMPORTANT: Use list first to get reminder IDs

Before editing, always run list to get the reminder's id field. The id is an EventKit calendarItemIdentifier (UUID-like string).

---

4) Delete Reminder

Trigger Examples (by language)

English:

• "Delete the meeting reminder"

Korean (한국어):

• "회의 미리알림 삭제해줘"

Command Invocation

node skills/mac-reminders-agent/cli.js delete --id "ABC123" --locale ko

Parameters

• --id (required): Reminder ID (from list output)
• --locale (optional): Response language

---

5) Complete Reminder

...