note-calendar

Synchronize macOS Calendar events and WPS Notes via osascript and python3 scripts.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/dy9759/SkillCollection --skill note-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: note-calendar
Source: https://github.com/dy9759/SkillCollection/tree/main/skills/note-calendar
Command: npx skills add https://github.com/dy9759/SkillCollection --skill note-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates manual calendar-note friction by connecting macOS Calendar with WPS Notes, enabling automated queries, event creation/movement/deletion, and bi-directional task synchronization so users can keep schedules and planning pages consistent without switching apps.

Core Features & Use Cases

  • Calendar queries: Natural-date queries (today/tomorrow/week/+N/range) with formatted outputs for quick inspection.
  • Calendar → Note (Daily Planning): Aggregate today's events, find related notes, and write a structured "Today's Plan" page into WPS Notes.
  • Note → Calendar: Parse notes for time-intent items and TODOs, confirm with the user, and add events to macOS Calendar.
  • Smart preparation & planning: Generate preparatory TODOs based on upcoming events (travel, presentations, exams), perform global time-block planning, and consolidate TODOs across notes.
  • Operational robustness: macOS-only checks, CLI-first wpsnote-cli with MCP fallback, UID caching for event operations, and comprehensive cal-* scripts with tests.

Quick Start

Ask the skill to check today's calendar and write a structured "Today's Plan" page into your WPS note.

Frequently Asked Questions about note-calendar

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

FAQPage Schema
How do I sync macOS Calendar events with WPS Notes for daily planning?

You can parse WPS Notes for time-intent items and TODOs, then convert them into macOS Calendar events. The Skill confirms extracted timed items with you before adding them to your calendar, ensuring accurate schedule creation from notes.

Can I extract TODOs from WPS Notes and add them to macOS Calendar?

You can extract TODOs and time-intent items from WPS Notes and convert them to macOS Calendar events. The Skill parses notes, confirms items with the user, and adds them as calendar events using osascript-driven scripts.

Do I need osascript to run calendar and note synchronization on macOS?

osascript is required to run the cal-* scripts for calendar synchronization on macOS. The Skill also uses python3 helpers and a wpsnote-cli with fallback to a user-wpsnote MCP service for reliable CRUD operations.

What's the best way to aggregate cross-note TODOs for weekly schedule planning?

The best way to aggregate cross-note TODOs is using this Skill's global time-block planning feature. It consolidates TODOs across WPS Notes, generates preparatory TODOs based on upcoming events, and provides smart preflight suggestions for weekly planning.

Does this calendar and note sync tool work on Windows or Linux?

No, this calendar and note sync tool only works on macOS. It relies on osascript-driven bin/cal-* scripts and macOS Calendar integration, making macOS-only checks a required operational constraint for schedule queries and event CRUD operations.