home / google-workspace / gcalcli

gcalcli

3.7k

Google Calendar CLI for listing calendars, querying events, adding or importing events, and running reminders from the terminal.

$brew install gcalcli
Language
Python
Stars
3,658
Category
Google Workspace
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

gcalcli is a community-maintained CLI for working with Google Calendar from the shell. It focuses on event lookup, calendar views, event creation or import, and reminder automation rather than broader Google Workspace administration.

What It Enables
  • List calendars and query upcoming, updated, or conflicting events across selected calendars, including agenda and calendar-style views.
  • Create events with quick-add or detailed fields, delete or edit matched events, and import ICS or vCal invites into a calendar.
  • Run reminder commands before upcoming events and script calendar lookups for cron jobs, shell workflows, or follow-up tooling.
Agent Fit
  • Event query commands expose real --json and --tsv output, which makes search, agenda, updates, conflicts, and calendar views workable in inspect-then-act loops.
  • The command surface is shell-friendly once auth is in place: commands are flag-driven, calendar selection can be configured, and reminders can hand off to another command.
  • Automation still has friction: initial auth requires your own Google Cloud OAuth client plus browser approval, edit stays interactive, and delete only becomes headless with --iamaexpert.
Caveats
  • You need to create your own Google Calendar API OAuth client and complete a browser-based consent flow before most commands work.
  • Some mutation paths are human-first: edit always prompts, delete prompts unless you bypass it, and verbose imports can ask for confirmation per event.