gcalcli

Manage Google Calendar events from the command line using gcalcli.

7|1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/benthomasson/shared-understanding --skill gcalcli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gcalcli
Source: https://github.com/benthomasson/shared-understanding/tree/main/skills/gcalcli
Command: npx skills add https://github.com/benthomasson/shared-understanding --skill gcalcli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to view Google Calendar events, add new events, and manage reminders directly from the command line, reducing context switching and improving scheduling efficiency.

Core Features & Use Cases

  • Agenda & Views: Quickly view today's agenda, weekly, or monthly calendars from the terminal.
  • Event Management: Add, update, or remove events with natural CLI commands.
  • Search & List: List calendars, search events by keyword, and filter by date ranges to prep for meetings.
  • Use Case: Example: you need to schedule a standup, check conflicts, and add a reminder for tomorrow at 10am, all from a single shell session.

Quick Start

Use the gcalcli skill to interact with Google Calendar from the command line. Examples: uvx --from "/Users/ben/git/gcalcli" gcalcli agenda uvx --from "/Users/ben/git/gcalcli" gcalcli add --title "Team Sync" --when "tomorrow 10am" --duration 60 uvx --from "/Users/ben/git/gcalcli" gcalcli list uvx --from "/Users/ben/git/gcalcli" gcalcli search "standup"

Frequently Asked Questions about gcalcli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Google Calendar events from the command line?

You can manage Google Calendar events from the command line by using this tool to view agendas, add new events, and update reminders directly within your terminal session. It relies on the gcalcli tool and Google Calendar OAuth authentication to operate within a properly configured environment.

Can I view my daily agenda and schedule meetings without leaving the terminal?

Yes, you can view your daily agenda and schedule meetings without leaving the terminal. The tool supports agenda viewing for today, weekly, or monthly calendars, and allows you to add events with natural CLI commands like specifying a title, time, and duration.

Does gcalcli require OAuth authentication to access Google Calendar?

Yes, gcalcli requires Google Calendar OAuth authentication to access your calendars. You must operate within a properly configured environment to ensure the command line interface can securely connect to and manage your Google Calendar events.

What is the best way to search for upcoming calendar events by keyword?

The best way to search for upcoming calendar events by keyword is using the text-based search functionality provided by this tool. You can search events by keyword and filter by date ranges across your calendars to quickly prep for meetings.

How do I list all my available Google Calendars in a CLI environment?

You list all your available Google Calendars in a CLI environment by executing the list command. This functionality displays all calendars associated with your authenticated Google account, allowing you to verify which calendars are accessible for event management.