calendar

Headless Google Calendar access via the official Google API client. Every command is python3 scripts/gcal.py [--calendar ID] <subcommand> [flags] and prints JSON to stdout.

Authentication is non-interactive: the skill reads a ready-to-use credential from GOOGLE_CREDENTIALS_JSON and refreshes access tokens itself. The agent never logs in. If that env var is missing or holds the wrong kind of JSON, the scripts exit with an explanation — see Authentication below.

The CLI script is gcal.py (NOT calendar.py — that name would shadow Python's stdlib calendar module and break imports).

Shares its auth layer (scripts/google_client.py, scripts/authorize.py) and the single GOOGLE_CREDENTIALS_JSON credential with the gmail skill. Authorize once and both skills work.

Setup