gccli

1# Google Calendar CLI
2 
3Command-line interface for Google Calendar operations.
4 
5## Installation
6 
7```bash
8npm install -g @mariozechner/gccli
9```
10 
11## Setup
12 
13### Google Cloud Console (one-time)
14 
151. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing)
162. [Enable the Google Calendar API](https://console.cloud.google.com/apis/api/calendar-json.googleapis.com)
173. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding
184. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use)
195. [Create OAuth client](https://console.cloud.google.com/auth/clients):
20   - Click "Create Client"
21   - Application type: "Desktop app"
22   - Download the JSON file
23 
24### Configure gccli
25 
26First check if already configured:
27```bash
28gccli accounts list
29```
30 
31If no accounts, guide the user through setup:
321. Ask if they have a Google Cloud project with Calendar API enabled
332. If not, walk them through the Google Cloud Console steps above
343. Have them download the OAuth credentials JSON
354. Run: `gccli accounts credentials ~/path/to/credentials.json`
365. Run: `gccli accounts add <email>` (use `--manual` for browserless OAuth)
37 
38## Usage
39 
40Run `gccli --help` for full command reference.
41 
42Common operations:
43- `gccli <email> calendars` - List all calendars
44- `gccli <email> events <calendarId> [--from <dt>] [--to <dt>]` - List events
45- `gccli <email> event <calendarId> <eventId>` - Get event details
46…