magic-calendar

Create and manage calendar projects with events, categories, and recurrence rules.

5.0k|557|Updated May 14, 2025
One-click install
npx skills add https://github.com/dtyq/magic --skill magic-calendar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: magic-calendar
Source: https://github.com/dtyq/magic/tree/main/backend/super-magic/agents/skills/magic-calendar
Command: npx skills add https://github.com/dtyq/magic --skill magic-calendar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating schedules, content plans, and events across a team often means juggling spreadsheets or disconnected tools. This Skill lets you create structured calendar projects and manage events, categories, and recurring schedules entirely through tool calls, keeping all calendar data consistent and queryable.

Core Features & Use Cases

  • Calendar Project Setup: Initialize a calendar project folder with a name, description, timezone, and optional color-coded categories.
  • Full Event Management: Add, list, update, and delete events with support for timed and all-day formats, locations, statuses, and categories.
  • Recurring Events: Define daily, weekly, or monthly recurrence rules with intervals, specific weekdays, and end dates.
  • Use Case: Build a 30-day content publishing calendar with "Publish" and "Review" categories, add a recurring weekly review meeting, and query all events scheduled for the coming week.

Quick Start

Ask the agent to create a content publishing calendar for next month with a weekly recurring review meeting every Monday, Wednesday, and Friday.

Frequently Asked Questions about magic-calendar

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

FAQPage Schema
How do I create a calendar project with events?

First create the project folder with shell_exec, then call setup_calendar_project with the folder path and calendar name. After initialization, use manage_calendar with the add_event action to add events, requiring only a title and start time.

How do I add recurring events to a calendar?

Pass a JSON recurrence string when calling add_event, specifying type (daily, weekly, or monthly), interval, and optional end_date. Weekly rules accept days_of_week (1=Monday to 7=Sunday), and monthly rules accept day_of_month.

What time format does the calendar event tool accept?

Timed events use the format YYYY-MM-DD HH:MM, while all-day events use YYYY-MM-DD only. Seconds and timezone suffixes are not supported; the project timezone is set during setup_calendar_project.

Can I update only part of an existing calendar event?

Yes, update_event performs partial updates, so you only pass the event_id plus the fields you want to change. Omitted fields keep their current values, and event IDs come from add_event or list_events results.

Why does setup_calendar_project fail on a new folder?

The tool does not create folders itself, so the target directory must already exist. Run shell_exec with a mkdir command first, then call setup_calendar_project with the existing folder path.