gcalendar is a command-line tool to read your Google Calendar events in JSON format.

Follow these instructions to install gcalendar on your Debian based Linux system:
sudo apt install python3-pip python3-setuptools python3-dateutil python3-oauth2client python3-googleapi git
git clone https://github.com/slgobinath/gcalendar.git
cd gcalendar
pip3 install -e .

usage: gcalendar [-h] [--no-of-days NO_OF_DAYS]
                   [--calendar [CALENDAR [CALENDAR ...]]] [--list-calendars]
                   [--client-id CLIENT_ID] [--client-secret CLIENT_SECRET]
                   [--account ACCOUNT] [--reset]

Retrieve Google Calendar events.

optional arguments:
  -h, --help            show this help message and exit
  --no-of-days NO_OF_DAYS
                        number of days to include
  --calendar [CALENDAR [CALENDAR ...]]
  --client-id CLIENT_ID
                        the Google client id
  --client-secret CLIENT_SECRET
                        the Google client secret
  --account ACCOUNT     an alphanumeric name to uniquely identify the account
  --reset               reset the the account

Privacy Policy

Gobinath built gcalendar as a Free and Open Source tool to view Google Calendar events on the terminal. This command-line tool is provided by Gobinath at no cost and is intended for use as is.

This page is used to inform visitors regarding my policies with the collection, use, and disclosure of Personal Information if anyone decided to use gcalendar.

gcalendar requires you to authorize it to access your Google calendar events. gcalendar requires only read permission and does not modify any of your events. OAuth tokens will be stored in your computer itself and will not be shared with anyone else. gcalendar uses the token to retrieve your calendar events and show them on your desktop.

None of your data is collected, stored, processed or shared with me (the developer) or any third-parties.
You are more than welcome to check the source code or reach me out if you have any questions.

The app does rely on Google Calendar API services that may collect information used to identify you. I highly recommend you to read Google Privacy Policy for more information.

Links to Other Services

This utility does not contain any links to any third-party services. The only service accessed by gcalendar is Google Calendar. I have no control over and assume no responsibility for the content, privacy policies, or practices of Google Calendar sites or services.

How gcalendar Works

gcalendar only uses the https://www.googleapis.com/auth/calendar.readonly scope to read your Google calendars and events from each calendar. In order to read your calendar events, you must authorize gcalendar as shown in this video:

The authorized token is stored in your local machine in ~/.config/gcalendar folder. You can revoke this token anytime by deleting those tokens from the folder manually or using gcalendar --reset command. Other than the token, none of your data is stored on your disk.

gcalendar directly reads your Google Calendar events and prints them on your terminal. No third-party services are used in the process. None of your data is shared with the developer (Gobinath Loganathan) or any third parties. Calendar events retrieved by gcalendar are only formatted and printed on the terminal. There are no other operations performed on your events.

Changes to This Privacy Policy

I may update the Privacy Policy from time to time. Thus, you are advised to review this page periodically for any changes. I will notify you of any changes by posting the new Privacy Policy on this page. These changes are effective immediately after they are posted on this page.


If you have any questions or suggestions about this Privacy Policy, do not hesitate to contact me.

Contact Form


Email *

Message *