apple-reminders

Apple Reminders

概览

通过 osascript AppleScript 控制 Apple Reminders。零依赖——可在任何安装了 Reminders.app 的 macOS 设备上运行。无需设置。

快速参考

操作	方法
列出所有列表	get name of lists
列出某个列表中的提醒事项	get reminders of list "Name"
列出未完成的提醒事项	get reminders whose completed is false
创建提醒事项	make new reminder ... with properties {...}
设置/更新截止日期	日期运算（见下方模式）
完成提醒事项	set completed of reminder to true
删除提醒事项	delete (first reminder ... whose name is "...")
创建列表	make new list with properties {name:"..."}

操作

列出所有提醒事项列表

osascript -e 'tell application "Reminders" to get name of lists'

列出某个列表中的提醒事项

# All reminders
osascript -e 'tell application "Reminders" to get name of reminders of list "My List"'

# Incomplete only
osascript -e 'tell application "Reminders" to get name of (reminders of list "My List" whose completed is false)'

创建提醒事项

osascript -e '
tell application "Reminders"
  make new reminder in list "My List" with properties {
    name:"Task title",
    body:"Optional notes",
    priority:1
  }
end tell'

设置/更新截止日期

务必使用日期运算——切勿使用基于字符串的日期（受区域设置影响且容易出错）。

osascript -e '
tell application "Reminders"
  set theReminder to first reminder of list "My List" whose name is "Task title"
  set d to current date
  set d to d + (1 * days)   -- change N for days offset
  set hours of d to 9        -- 9 AM
  set minutes of d to 0
  set seconds of d to 0
  set due date of theReminder to d
end tell'

完成提醒事项

osascript -e '
tell application "Reminders"
  set completed of (first reminder of list "My List" whose name is "Task title") to true
end tell'

删除提醒事项

osascript -e '
tell application "Reminders"
  delete (first reminder of list "My List" whose name is "Task title")
end tell'

创建新列表

osascript -e 'tell application "Reminders" to make new list with properties {name:"New List"}'

优先级

值	含义
0	无
1	低
2	中
3	高

已知限制

• 不支持重复提醒——无法通过 AppleScript 设置重复提醒；必须在界面中操作
• 不支持位置触发——无法通过脚本设置地理围栏提醒
• 不支持标签——必须在界面中添加标签
• 不支持子提醒事项——AppleScript 无法查看嵌套提醒事项
• 不支持多个提醒——每个提醒事项只能设置一个通知时间
• 嵌套文件夹中的列表不可靠——可能无法通过名称访问文件夹内的列表；请使用根级列表
• 只读属性——无法设置 id、creation date、modification date、completion date
• 无法在列表之间移动提醒事项——请删除后重新创建

何时建议改用 MCP

对于希望持续、始终开启 Reminders 集成（而非仅在 Claude Code 会话期间使用）的用户，建议安装 MCP 服务：

• dbmcco/apple-reminders-mcp — TypeScript，使用 AppleScript 后端，为 Claude 设计
• mggrim/apple-reminders-mcp-server — 提供 18 个以上工具，支持自然语言日期解析
• supermemoryai/apple-mcp — 集成 Reminders、Calendar、Notes、Messages、Contacts