caldav-cli

# caldav-cli

A CalDAV CLI client. Manages multiple accounts with secure OS keychain storage. Supports iCloud, Google (OAuth2), Yandex and any custom CalDAV server.

## Installation

Requires Node.js >= 18.

```bash
npm install -g caldav-cli
```

After installation the `caldav-cli` command is available globally.

## Quick Start

```bash
caldav-cli account add          # Interactive wizard: pick provider, enter credentials
caldav-cli events list          # Show events for the next 7 days
caldav-cli events create        # Interactive wizard: create a new event
```

## Account Management

Add account (interactive wizard — prompts for provider, credentials, tests connection):
```bash
caldav-cli account add
```

List configured accounts:
```bash
caldav-cli account list
```

Remove an account:
```bash
caldav-cli account remove <name>
```

## View Events

```bash
caldav-cli events list                           # Next 7 days (default)
caldav-cli events list --from 2026-02-10 --to 2026-02-20
caldav-cli events list -a work                   # Specific account
caldav-cli events list -c "Team Calendar"        # Filter by calendar name
caldav-cli events list -a work -c Personal --from 2026-03-01 --to 2026-03-31
```

JSON output (for scripting):
```bash
caldav-cli events list --json
caldav-cli events list --json --from 2026-02-10 --to 2026-02-20
```

## Create Events

Interactive wizard (prompts for all fields):
```bash
caldav-cli events create
```

Non-interactive (all options via flags):
```bash
caldav-cli events create \
  --title "Team standup" \
  --start "2026-02-10T10:00" \
  --end "2026-02-10T10:30" \
  --account work \
  --calendar "Team Calendar" \
  --description "Daily sync" \
  --location "Room 42"
```

Partial flags (wizard prompts for the rest):
```bash
caldav-cli events create --title "Lunch" --account work
```

JSON output after creation:
```bash
caldav-cli events create --json --title "Event" --start "2026-02-10T10:00" --end "2026-02-10T11:00"
```

## Supported...