Google Calendar CLI

Installation

npm install -g @mariozechner/gccli

Setup

Google Cloud Console (one-time)

1. Create a new project (or select existing)
2. Enable the Google Calendar API
3. Set app name in OAuth branding
4. Add test users (all Gmail addresses you want to use)
5. Create OAuth client:
   • Click "Create Client"
   • Application type: "Desktop app"
   • Download the JSON file

Configure gccli

gccli accounts list

1. Ask if they have a Google Cloud project with Calendar API enabled
2. If not, walk them through the Google Cloud Console steps above
3. Have them download the OAuth credentials JSON
4. Run:

   gccli accounts credentials ~/path/to/credentials.json

5. Run:

   gccli accounts add <email>

   (use

   --manual

   for browserless OAuth)

Usage

gccli --help

• gccli <email> calendars

  - List all calendars

• gccli <email> events <calendarId> [--from <dt>] [--to <dt>]

  - List events

• gccli <email> event <calendarId> <eventId>

  - Get event details

• gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt>

  - Create event

• gccli <email> freebusy <calendarIds> --from <dt> --to <dt>

  - Check availability

primary

Date/Time Format

• Timed events:

  YYYY-MM-DDTHH:MM:SSZ

  (UTC) or

  YYYY-MM-DDTHH:MM:SS

  (local)
• All-day events:

  YYYY-MM-DD

  with

  --all-day

  flag

Data Storage

• ~/.gccli/credentials.json

  - OAuth client credentials

• ~/.gccli/accounts.json

  - Account tokens