Mac Reminder Bridge

该 Skill 借助运行在 macOS 宿主机上的 HTTP 监听服务（listener.py，端口 5000），让 Docker 内的智能体控制原生提醒事项应用：新增、更新、删除提醒，标记完成或重新打开，查询提醒与清单，并提供健康检查与可选的请求头密钥。仓库另含说明文档、Python 依赖清单和发送提醒的 shell 脚本；README 声明代码与文档由模型自动生成，端点包含删除类破坏性操作。

masteryuuuu

热度 53.19

最近更新 2026-05-11 17:31:20

分类：自动化依赖：第三方 API / 代码执行应用场景：任务管理 / 日程安排 / 工作流 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add mac-reminder-bridge

Metadata

name: mac-reminder-bridge
description: Manage macOS Reminders.app from Docker via HTTP bridge. Use when user says: set/add/create a reminder, remind me to X, cancel/delete a reminder, mark reminder done/complete, update/edit a reminder, show/list my reminders. Requires listener.py running on Mac at port 5000.
metadata: {"openclaw":{"emoji":"🔔","requires":{"bins":["curl"]}}}

Skill: Mac Reminder Bridge

Control macOS Reminders.app from inside Docker via HTTP. Base URL: http://host.docker.internal:5000

When to use

User intent	Endpoint
"Remind me to / Set a reminder / Add a reminder"	POST `/add_reminder`
"Cancel / Delete my reminder to ..."	POST `/delete_reminder`
"Done with / Mark ... as complete"	POST `/complete_reminder`
"Unmark / reopen reminder ..."	POST `/complete_reminder` with `completed:false`
"Update / Change / Edit my reminder ..."	POST `/update_reminder`
"What are my reminders / Show reminders"	GET `/list_reminders`
"What lists do I have"	GET `/list_lists`

POST /add_reminder

{
  "task":      "Buy groceries",
  "list":      "Shopping",
  "due":       "2025-12-31 09:00",
  "remind_at": "2025-12-31 08:50",
  "notes":     "Get milk and eggs",
  "priority":  "high"
}

task required; all others optional
due / remind_at format: YYYY-MM-DD HH:MM
priority: none | low | medium | high
list: leave empty to use the default list

POST /update_reminder

{
  "task":         "Buy groceries",
  "fuzzy":        false,
  "new_task":     "Buy organic groceries",
  "new_due":      "2025-12-31 10:00",
  "new_notes":    "Also get juice",
  "new_priority": "medium"
}

task identifies which reminder to update
Set new_due to "" to clear the due date
Only include the fields you want to change

POST /delete_reminder

{ "task": "Buy groceries", "fuzzy": false, "list": "" }

fuzzy: true → match by "contains" (useful when unsure of exact wording)
list: leave empty to search ALL lists

POST /complete_reminder

{ "task": "Buy groceries", "completed": true, "fuzzy": false }

completed: false → un-check / reopen the reminder

GET /list_reminders

GET /list_reminders
GET /list_reminders?list=Shopping
GET /list_reminders?completed=true
GET /list_reminders?completed=all

Returns structured JSON with task, due, notes, priority, completed, list.

GET /list_lists

Returns all lists with pending/total counts and the default list name.

GET /health

Check if listener is running and has Reminders permission.

Agent step-by-step

Adding a reminder

Extract: task (required), due, remind_at, notes, priority, list
POST /add_reminder
Confirm: "✅ Reminder set: " + due date if applicable

Deleting a reminder

Extract task name; use fuzzy: true if unsure of exact wording
POST /delete_reminder
Check count: if 0, say "⚠️ No reminder found matching ''"

Updating a reminder

Extract current name and what to change
POST /update_reminder with only the changed fields
Confirm what was changed

Listing reminders

GET /list_reminders (add ?list=X if user specifies a list)
Format results clearly, grouping by list if multiple lists present

Health check before important ops

curl http://host.docker.internal:5000/health

Auth header (if BRIDGE_SECRET is set)

X-Bridge-Secret: <secret>