gcalcli is a command-line interface for Google Calendar that lets you manage your calendar events from the terminal.
The tool solves the problem of accessing and managing Google Calendar without leaving the command line. It uses the Google Calendar API version 3 and OAuth2 authentication to connect to your Google account. The approach is straightforward: gcalcli provides subcommands for common calendar operations, allowing you to list calendars, view agendas across specified date ranges, search for events, add or delete events, edit existing events, and import events from ICS or vCal files. It can also function as a reminder service by executing commands when events are approaching, making it suitable for integration with cron jobs and shell scripts.
You should choose gcalcli if you work primarily in the terminal and want to avoid switching to a graphical calendar application. It suits developers and system administrators who prefer command-line workflows and want to automate calendar operations through scripts. The tool is particularly useful for those who receive calendar invites in ICS format from email clients or Exchange systems and need to import them programmatically. The project requires Python 3 and can be installed via package managers on several Linux distributions, Homebrew on macOS, or pip from PyPI. Note that you must provide your own Google Calendar API credentials; the project's shared token is restricted and awaiting approval.
The project maintains active engagement with its codebase through regular updates and responsive handling of issues. Development includes ongoing refinement of features and user experience improvements based on community feedback. The maintainers continue to expand the tool's capabilities while keeping the core functionality stable and reliable for existing users.
