gcalcli

gcalcli [options] command [args]

gcalcli is a command-line interface for Google Calendar that enables terminal-based calendar management without opening a web browser. It authenticates via OAuth 2.0 and provides full access to your Google Calendar data.
The tool supports both viewing operations like agenda and calendar displays, and modification operations including creating, editing, and deleting events. Quick add functionality allows natural language event creation, while the structured add command provides precise control over event details.
gcalcli is particularly useful for terminal-centric workflows, automation scripts, and integration with other command-line tools. It can display calendar data in various formats and supports working with multiple calendars simultaneously.

--calendar name

Specify calendar.

Event title.

Event start time.

Event duration.

Event location.

Line art style: fancy, unicode, or ascii.

Execute command without using cache.

Set locale for date/time output.

Delete and refresh cached data.

~/.gcalclirc

Configuration file with commonly-used CLI options, one per line. Can also use @file syntax to load options from any file.

OAuth 2.0 credentials for Google Calendar API access.

agenda

Show upcoming events.

List calendars.

Weekly calendar view.

Monthly calendar view.

Add an event.

Quick add event.

Search events.

Delete an event.

Edit an event.

Import events from an ics/vcal file.

Execute a command if event occurs within a specified time.

gcal(1), calcurse(1)