---
name: sundial-org-calctl
description: "Manage Apple Calendar events via icalBuddy + AppleScript CLI"
metadata:
  decimalai-skill-id: "536d6a18-187f-419d-9393-b182a3e56191"
  decimalai-version-id: "471cca45-38c8-4e00-b844-5755e717aaa6"
  decimalai-version: "1"
  decimalai-body-sha256: "866d2c30f3093ed8d67b9a47c8ba36475c3f8a0fd55edfe04f77e5ceab6d93d8"
  decimalai-name: "sundial-org/calctl"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "productivity"
  decimalai-source: "https://app.decimal.ai/s/sundial-org-calctl@1/SKILL.md"
---
# calctl - Apple Calendar CLI

Manage Apple Calendar from the command line using icalBuddy (fast reads) and AppleScript (writes).

**Requirements:** `brew install ical-buddy`

## Commands

| Command | Description |
|---------|-------------|
| `calctl calendars` | List all calendars |
| `calctl show [filter]` | Show events (today, tomorrow, week, YYYY-MM-DD) |
| `calctl add <title>` | Create a new event |
| `calctl search <query>` | Search events by title (next 30 days) |

## Examples

```bash
# List calendars
calctl calendars

# Show today's events
calctl show today

# Show this week's events
calctl show week

# Show events from specific calendar
calctl show week --calendar Work

# Show events on specific date
calctl show 2026-01-25

# Add an event
calctl add "Meeting with John" --date 2026-01-22 --time 14:00

# Add event to specific calendar
calctl add "Team Standup" --calendar Work --date 2026-01-22 --time 09:00 --end 09:30

# Add all-day event
calctl add "Holiday" --date 2026-01-25 --all-day

# Add event with notes
calctl add "Project Review" --date 2026-01-22 --time 15:00 --notes "Bring quarterly report"

# Search for events
calctl search "meeting"
```

## Options for `add`

| Option | Description | Default |
|--------|-------------|---------|
| `-c, --calendar <name>` | Calendar to add event to | Privat |
| `-d, --date <YYYY-MM-DD>` | Event date | today |
| `-t, --time <HH:MM>` | Start time | 09:00 |
| `-e, --end <HH:MM>` | End time | 1 hour after start |
| `-n, --notes <text>` | Event notes | none |
| `--all-day` | Create all-day event | false |

## Available Calendars

Common calendars on this system:
- Privat (personal)
- Work
- Familien Kalender
- rainbat solutions GmbH
- TimeTrack