mcpField
R
reminder-scheduler

reminder-scheduler

github.com/cklxxProductivity11111 installsUpdated 31w ago
Repository

About reminder-scheduler

A skill and Python CLI for managing one-time reminders and recurring plans. It supports creating, listing, cancelling or deleting entries, scanning due plans, and advancing a plan after execution.

Key features

  1. 01Schedule delayed one-time reminders
  2. 02List and cancel one-time reminders
  3. 03Create and update recurring plans
  4. 04List and delete plans
  5. 05Scan plans that are due
  6. 06Advance a plan's next run time

Use cases

  1. 01Setting a reminder for a later time
  2. 02Maintaining a weekly review reminder
  3. 03Checking which recurring plans are due
  4. 04Updating a plan after its reminder runs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cklxx/elephant.ai --skill reminder-scheduler

After installing, type/reminder-schedulerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

run.py
tests/
__init__.py
test_reminder_scheduler.py

Details

From the project README

reminder-scheduler

一个 skill 同时覆盖两类能力：

  • 单次提醒：延迟触发（如 30 分钟后提醒）
  • 周期计划：维护长期提醒计划（如每周复盘）

调用

# 单次提醒：设置、查看、取消
python3 skills/reminder-scheduler/run.py set_once --delay 30m --task "喝水提醒"
python3 skills/reminder-scheduler/run.py list_once
python3 skills/reminder-scheduler/run.py cancel_once --id timer-12345

# 周期计划：创建/更新、查看、删除、到期扫描、执行后推进
python3 skills/reminder-scheduler/run.py upsert_plan --name weekly-retro --schedule "0 18 * * 5" --task "发送复盘提醒" --next-run-at 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py list_plans
python3 skills/reminder-scheduler/run.py due_plans --now 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py delete_plan --name weekly-retro
python3 skills/reminder-scheduler/run.py touch_plan --name weekly-retro --next-run-at 2026-03-13T10:00:00Z

参数

set_once
参数类型必填说明
delaystring是延迟时间（30s / 5m / 2h）
taskstring是提醒内容
cancel_once
参数类型必填说明
idstring是单次提醒 ID
upsert_plan
参数类型必填说明
namestring是计划名（唯一键）
schedulestring是周期表达式（cron 字符串）
taskstring是提醒内容
next_run_atstring否下一次执行时间（ISO8601）
channelstring否渠道，默认 lark
enabledbool否是否启用，默认 true
metadataobject否扩展元数据
list_plans

无参数，返回当前所有周期计划。

delete_plan
参数类型必填说明
namestring否计划名；与 id 至少提供一个
idstring否计划 ID；与 name 至少提供一个

当同时提供 name 和 id 时，必须命中同一条记录才会删除。

due_plans
参数类型必填说明
nowstring否当前时间（ISO8601）；未提供时取系统 UTC 时间
touch_plan
参数类型必填说明
namestring否计划名；与 id 至少提供一个
idstring否计划 ID；与 name 至少提供一个
next_run_atstring否更新下一次执行时间（ISO8601）

当同时提供 name 和 id 时，必须命中同一条记录才会更新。

Comments

Markdown supported