calendar-reminders

Generate JSON reminder plans from Google Calendar and CalDAV events.

1|Updated May 20, 2026
One-click install
npx skills add https://github.com/Wanli-Lee/CUA-Claw-Harness --skill calendar-reminders-wanli-lee
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calendar-reminders
Source: https://github.com/Wanli-Lee/CUA-Claw-Harness/tree/main/skills/1/calendar-reminders
Command: npx skills add https://github.com/Wanli-Lee/CUA-Claw-Harness --skill calendar-reminders-wanli-lee

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you turn upcoming Google Calendar and optional CalDAV (khal) events into timely reminder plans, so important events don’t get missed and reminders don’t require manual coordination.

Core Features & Use Cases

  • Config-driven calendar ingestion: Reads event data from Google Calendar via gcalcli and (optionally) from CalDAV via vdirsyncer+khal, using a single JSON configuration file.
  • Rule-based reminder planning: Filters out birthdays (optional), marks timed events as important, and only triggers all-day reminders when event titles match configured keywords.
  • JSON plan for one-shot OpenClaw reminders: Generates a structured JSON output containing reminderAtUtc times and messages, intended to be consumed by a separate scheduler (cron or an agent turn).

Quick Start

Ask the skill runner to execute calendar-reminders with your config path so it prints a JSON reminder schedule plan for today.

Frequently Asked Questions about calendar-reminders

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate calendar reminders from Google Calendar events?

You can generate calendar reminders automatically by using a config-driven Skill that retrieves Google Calendar events via gcalcli and outputs a structured JSON plan of one-shot reminder times for scheduling. It filters timed events and matches all-day events by keyword.

How do I create a reminder schedule plan from both Google Calendar and CalDAV events?

To create a reminder schedule plan from Google Calendar and CalDAV, configure a single JSON file to ingest events via gcalcli and vdirsyncer+khal. The Skill processes both sources and outputs a unified JSON plan with reminderAtUtc times for your scheduler.

Does calendar-reminders support filtering out birthdays and all-day events?

Yes, calendar-reminders supports filtering out birthdays optionally and only triggers all-day reminders when event titles match configured keywords. Timed events are automatically marked as important for reminder planning.

How do I use a JSON configuration file to plan one-shot calendar reminders?

You use a JSON configuration file by setting the OPENCLAW_CALENDAR_CONFIG path to define calendar sources and keyword rules. The Skill reads this config, retrieves events via gcalcli, and generates a reminderAtUtc-ready JSON output for OpenClaw scheduling.

What is the best way to automate daily reminder planning for time-critical appointments?

The best way to automate daily reminder planning is using a rule-based system that retrieves calendar events and outputs a structured JSON plan of reminder times. This approach supports time-critical appointments and keyword-matched all-day events without manual coordination.

Do I need gcalcli and OAuth to retrieve Google Calendar events for reminder planning?

Yes, you need gcalcli with OAuth-assisted retrieval to access Google Calendar events for reminder planning. The Skill uses safe subprocess invocation without shell parsing to retrieve events and generate a JSON reminder schedule plan.