Google Calendar CLI for listing calendars, querying events, adding or importing events, and running reminders from the terminal.
$brew install gcalcli
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
--jsonand--tsvoutput, 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,
editstays interactive, anddeleteonly 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:
editalways prompts,deleteprompts unless you bypass it, and verbose imports can ask for confirmation per event.