# Install gcalcli with Homebrew, apt, MacPorts, Nix, zypper Easily access your Google Calendar(s) from a command-line. Version 4.5.1 via Homebrew; verified 2026-05-21. ## Install ```sh sudo av install brew:gcalcli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install gcalcli ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install gcalcli ``` Evidence: MacPorts ports tree: office/gcalcli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install gcalcli ``` Evidence: Debian stable package indexes: gcalcli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#gcalcli ``` Evidence: nixpkgs package indexes: pkgs/by-name/gc/gcalcli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install gcalcli ``` Evidence: openSUSE Tumbleweed package metadata: gcalcli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:gcalcli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 4.5.1 - **Source summary:** Easily access your Google Calendar(s) from a command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-05-21T11:31:39Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - gcalcli (cli) - gcalcli (alias) ## Dependencies - certifi - cryptography - pycparser - pydantic - python@3.14 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 4.5.1 - Package-manager updated: 2026-05-21 - Local data: ok - Upstream repository: https://github.com/insanum/gcalcli - info: No cached GitHub release or tag data was available. ## Project history and usage gcalcli is a Python command-line interface for Google Calendar. It turns calendar viewing, event creation, reminders, ICS/vCal import, and shell integration into scriptable terminal workflows. ### Project history The GitHub repository was created in April 2012 and the current README documents gcalcli as a Python application using Google Calendar API v3. Its command set covers listing calendars, agenda and calendar views, quick event entry, detailed event editing, imports, reminders, and shell completion. ### Adoption history The project README explicitly tells users to check operating-system distribution packages, and documents Debian/Ubuntu, Void Linux, Nix, Homebrew, PyPI, pipx, and source installation paths. GitHub tags show an active 4.x series, including v4.5.1, after a long life as a small personal-productivity CLI. ### How it is used A normal setup authenticates with OAuth2, stores the resulting token in a platform data directory, and then uses subcommands such as agenda, calm, calw, quick, add, import, and remind. The configuration model includes config.toml in the platform config directory, GCALCLI_CONFIG for overrides, and legacy gcalclirc-style flag files. ### Why package nerds care gcalcli is a classic Unix productivity package: it wraps a web API in composable terminal commands, cron jobs, tmux or Conky status displays, mailcap attachment handlers, and shell completion. Its packaging is also a reminder that API-backed CLIs often ship with local credential storage and user-managed OAuth client setup. ### Timeline - 2012: Public GitHub repository created. - 2010s: gcalcli became packaged through operating-system and language package managers documented by the project. - 2020s: 4.x tags continued while the README documented Google Calendar API v3 and user-provided OAuth client setup. ### Related projects - The README ties gcalcli to Google Calendar API v3, Python packaging through PyPI and pipx, shell completion through argcomplete, and desktop integrations such as cron, tmux, Conky, and notification commands. ### Sources - - - - ## Security Notes No matching local secret-handling manifest was found for gcalcli. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/gcalcli/config.toml, ~/.config/gcalcli/gcalclirc ## Credential files - Linux: ~/.local/share/gcalcli/oauth ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** gcalcli - **Version Scheme:** 0 - **Revision:** 12 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - gcalcli - 4.5.1-1: normalized package name match | Debian stable package indexes: gcalcli from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Google Calendar Command Line Interface | https://github.com/insanum/gcalcli - Nix - gcalcli: normalized package name match | nixpkgs package indexes: pkgs/by-name/gc/gcalcli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - gcalcli - 4.3.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: gcalcli from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Google Calendar Command Line Interface | https://github.com/insanum/gcalcli - zypper - gcalcli - 4.3.0+git14.3e616f7-1.4: normalized package name match | openSUSE Tumbleweed package metadata: gcalcli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Google Calendar Command Line Interface | https://github.com/insanum/gcalcli - MacPorts - gcalcli: normalized package name match | MacPorts ports tree: office/gcalcli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [khal](https://www.automicvault.com/pkg/brew/khal/) - Shares av.db curated category or tags: calendar, cli, productivity, python. - [pcal](https://www.automicvault.com/pkg/brew/pcal/) - Shares av.db curated category or tags: calendar, cli, productivity. - [calcurse](https://www.automicvault.com/pkg/brew/calcurse/) - Shares av.db curated category or tags: calendar, cli, productivity. - [ccal](https://www.automicvault.com/pkg/brew/ccal/) - Shares av.db curated category or tags: calendar, cli, productivity. - [ddate](https://www.automicvault.com/pkg/brew/ddate/) - Shares av.db curated category or tags: calendar, cli, productivity. - [hebcal](https://www.automicvault.com/pkg/brew/hebcal/) - Shares av.db curated category or tags: calendar, cli, productivity. - [ical-buddy](https://www.automicvault.com/pkg/brew/ical-buddy/) - Shares av.db curated category or tags: calendar, cli, productivity. - [jcal](https://www.automicvault.com/pkg/brew/jcal/) - Shares av.db curated category or tags: calendar, cli, productivity. - [mcp-google-sheets](https://www.automicvault.com/pkg/brew/mcp-google-sheets/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cryptography, google, productivity. - [buku](https://www.automicvault.com/pkg/brew/buku/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, command-line, cryptography, line. - [bagels](https://www.automicvault.com/pkg/brew/bagels/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, productivity, pydantic, python. ## Combined YAML source View the package source record on GitHub. [combined/gcalcli.yml](https://github.com/automic-vault/db/blob/main/combined/gcalcli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph