LinuxCommandLibrary

gcalcli

command-line interface for Google Calendar

TLDR

Show agenda

$ gcalcli agenda
copy
List calendars
$ gcalcli list
copy
Show calendar view
$ gcalcli calw
copy
Show month view
$ gcalcli calm
copy
Add event
$ gcalcli add --title "[title]" --when "[tomorrow 2pm]" --duration [60]
copy
Quick add event
$ gcalcli quick "[Meeting tomorrow at 3pm]"
copy
Search events
$ gcalcli search "[query]"
copy
Delete event
$ gcalcli delete "[event title]"
copy

SYNOPSIS

gcalcli [options] command [args]

DESCRIPTION

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.

PARAMETERS

--calendar name

Specify calendar.
--title text
Event title.
--when time
Event start time.
--duration minutes
Event duration.

CONFIGURATION

~/.gcalclirc

Main configuration file containing OAuth credentials, calendar settings, and display preferences.
~/.gcalcli_oauth
OAuth 2.0 credentials for Google Calendar API access.

SUBCOMMANDS

agenda

Show upcoming events.
list
List calendars.
calw
Weekly calendar view.
calm
Monthly calendar view.
add
Add an event.
quick
Quick add event.
search
Search events.
delete
Delete an event.
edit
Edit an event.

SEE ALSO

gcal(1), calcurse(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community