gccli

Manage Google Calendar events, calendars, and availability from the command line.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/RavitejaKarra24/dotfiles --skill gccli-ravitejakarra24
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gccli
Source: https://github.com/RavitejaKarra24/dotfiles/tree/main/pi/.pi/agent/skills/pi-skills/gccli
Command: npx skills add https://github.com/RavitejaKarra24/dotfiles --skill gccli-ravitejakarra24

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mariozechner/gccli.

What problem does it solve? Accessing Google Calendar normally requires opening a browser or building custom API integrations. This Skill lets you list calendars, view and create events, and check availability directly from the terminal using the gccli CLI. ## Core Features & Use Cases - Calendar & Event Management: List calendars, view event details, and create events with timed or all-day formats. - Availability Checking: Run free/busy queries across one or more calendars to find open time slots. - Multi-Account OAuth Setup: Configure Google Cloud OAuth credentials and add multiple Gmail accounts, including browserless flows. - Use Case: Ask your agent to check whether you are free next Tuesday afternoon; it runs a freebusy query against your primary calendar and reports open slots without you leaving the terminal. ## Quick Start Ask the agent to list my upcoming events on my primary Google Calendar for this week using gccli.

Frequently Asked Questions about gccli

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

FAQPage Schema
How do I create a Google Calendar event from the command line?

Use gccli with the create command: gccli <email> create <calendarId> --summary <title> --start <datetime> --end <datetime>. Use 'primary' as the calendarId for your main calendar, and pass --all-day with YYYY-MM-DD dates for all-day events.

How do I check availability or free/busy time in Google Calendar via CLI?

Run gccli <email> freebusy <calendarIds> --from <datetime> --to <datetime> to query availability across one or more calendars. Datetimes use ISO format, either UTC with a Z suffix or local time.

What setup is required before using gccli with Google Calendar?

You need a Google Cloud project with the Calendar API enabled, OAuth branding configured, test users added, and a Desktop app OAuth client. Download the credentials JSON, register it with gccli accounts credentials, then add accounts with gccli accounts add.

Can gccli work in headless or browserless environments?

Yes. When adding an account, pass the --manual flag to gccli accounts add <email> to complete OAuth without opening a browser, which suits remote servers or SSH sessions.

Where does gccli store credentials and account tokens?

gccli stores the OAuth client credentials in ~/.gccli/credentials.json and per-account tokens in ~/.gccli/accounts.json. Keep these files private since they grant access to your calendars.