gcalcli

Google Calendar Command Line Interface

Introduction

gcalcli is a Google Calendar command-line interface. It is an open-source tool written in Python by Eric Davis.

gcalcli is a Python application that uses the Google Calendar API version 3 and allows you to access your Google Calendars from the command line. You can easily get your agenda, search for events, add new events, delete events, edit events, see recently updated events, or even import ICS/vCal invitations from Microsoft Exchange and/or other sources. In addition, gcalcli can act as a reminder service and execute any application you want when an event is about to happen.

First Time Users

1. This article demonstrates how to quickstart gcalcli via x-cmd
2. There's also a 1-minute tutorial of gcalcli on x-cmd to get you up and running

Features

• OAuth2 authention with your Google account
• list your calendars
• show an agenda using a specified start/end date and time
• show updates since a specified datetime for events between a start/end date and time
• find conflicts between events matching search term
• ascii text graphical calendar display with variable width
• search for past and/or future events
• "quick add" new events to a specified calendar
• "add" a new event to a specified calendar (interactively or automatically)
• "delete" event(s) from a calendar(s) (interactively or automatically)
• "edit" event(s) interactively
• import events from ICS/vCal files to a specified calendar
• easy integration with your favorite mail client (attachment handler)
• run as a cron job and execute a command for reminders
• work against specific calendars (by calendar name w/ regex)
• flag file support for specifying option defaults
• colored output and unicode character support
• super fun hacking with shell scripts, cron, screen, tmux, conky, etc

Common Use Cases

Example

# Get gcalcli via x
x env use gcalcli

# See gcalcli help docs
gcalcli --help

# Call gcalcli with your Client ID and Client Secret to login via the OAuth2 Authorization Screen
gcalcli --client-id=xxxxxxxxxxxxxxx.apps.googleusercontent.com --client-secret=xxxxxxxxxxxxxxxxx list

# Use gcalcli
gcalcli calw

Similar or Related Tools

• khal - A standards-based CLI and terminal calendar program written in Python. It has the ability to synchronize with CalDAV servers via vdirsyncer.
• plann - A simple command-line CalDAV client that lets you add calendar events, browse your agenda, and do task management.

Further Reading

• The project is hosted on Github, with the README containing detailed usage and option functionality
• Article gcalcli: A command line tool to interact with Google Calendar

Global Installation：

1. Automatically download the installation package and expand it locally.
2. Automatically create symbolic links for executable files in x-cmd's bin directory.
3. All currently open shells can directly use the command name.

x pkg use gcalcli

https://github.com/insanum/gcalcli
License	MIT
Language	"Python"
Version	v4.5.1 stable

Package Installation Support Provided for
x64
	Linux
	Darwin
	Windows
ARM64
	Linux
	Darwin

Package Binary Source from

Official Source
• https://pypi.org/project/gcalcli/

Repackaged from Official Source
• https://pypi.tuna.tsinghua.edu.cn/simple/gcalcli/

Related Link

Module

`x pkg` => usage