ical-cli

Manage macOS Apple Calendar events with CRUD operations via the ical CLI.

2|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/fredchu/claude-dotfiles --skill ical-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ical-cli
Source: https://github.com/fredchu/claude-dotfiles/tree/main/skills/ical-cli
Command: npx skills add https://github.com/fredchu/claude-dotfiles --skill ical-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the management of your macOS Apple Calendar events, allowing for easy creation, querying, updating, and deletion directly through a command-line interface.

Core Features & Use Cases

  • Event Management: Perform full CRUD operations on calendar events.
  • Natural Language Input: Understands various natural language triggers for calendar actions.
  • Use Case: Quickly add a new meeting to your 'Work' calendar for tomorrow at 2 PM, or check what events are scheduled for the upcoming week.

Quick Start

Add a new event titled "Team Sync" to your Work calendar for tomorrow from 2 PM to 3 PM.

Frequently Asked Questions about ical-cli

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

FAQPage Schema
How do I manage macOS Calendar events from the command line?

You can manage macOS Calendar events from the command line by using the local ical CLI binary. It supports full CRUD operations, allowing you to create, query, update, and delete calendar entries directly without opening the Calendar app.

Can I create macOS Calendar events using natural language input?

Yes, you can create macOS Calendar events using natural language input. The ical CLI tool understands various natural language triggers, allowing you to quickly add meetings or appointments by stating the event details, such as scheduling a team sync for tomorrow.

Does the ical CLI tool require any specific setup to manage Apple Calendar entries?

Yes, managing Apple Calendar entries requires the ical binary to be installed and accessible at a specified absolute path. This deterministic path configuration is necessary for the tool to execute calendar event operations successfully on macOS.

What's the best way to query upcoming calendar events on macOS without the GUI?

The best way to query upcoming calendar events without the macOS GUI is using the ical CLI tool. It allows you to check your schedule and retrieve details for upcoming events directly from your terminal, streamlining event querying operations.

Can I update and delete existing Apple Calendar events through a CLI tool?

Yes, you can update and delete existing Apple Calendar events through the ical CLI tool. It provides full CRUD capabilities, enabling you to modify or remove calendar entries directly from your macOS terminal interface.

Why does my macOS calendar event creation fail when using a CLI tool?

macOS calendar event creation may fail if the ical binary is not installed or not accessible at the required absolute path. Ensure the local ical CLI tool is properly configured for deterministic task execution to resolve event management issues.