agentskills.codes
GC

gccli

by badlogicProductivitySource

This tool provides CLI access to manage Google Calendar events, check availability, and list calendars across multiple accounts.

AutomationNode.js

Install

mkdir -p .claude/skills/gccli && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4390" && unzip -o skill.zip -d .claude/skills/gccli && rm skill.zip

Installs to .claude/skills/gccli

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Google Calendar CLI for listing calendars, viewing/creating/updating events, and checking availability.
103 charsno explicit “when” trigger
Beginner

Key capabilities

  • →List available Google calendars
  • →Query calendar events within specific date ranges
  • →Create new calendar events via CLI
  • →Check availability across multiple calendar IDs

How it works

It interfaces with the Google Calendar API using stored OAuth credentials to execute CLI commands for event and calendar management.

Inputs & outputs

You give it
Calendar ID and event parameters
You get back
Formatted event list or confirmation of event creation

When to use gccli

  • →Listing calendar events
  • →Creating new calendar events from CLI
  • →Checking meeting availability
  • →Managing multiple Google calendars

About this skill

Google Calendar CLI

Command-line interface for Google Calendar operations.

Installation

npm install -g @mariozechner/gccli

Setup

Google Cloud Console (one-time)

  1. Create a new project (or select existing)
  2. Enable the Google Calendar API
  3. Set app name in OAuth branding
  4. Add test users (all Gmail addresses you want to use)
  5. Create OAuth client:
    • Click "Create Client"
    • Application type: "Desktop app"
    • Download the JSON file

Configure gccli

First check if already configured:

gccli accounts list

If no accounts, guide the user through setup:

  1. Ask if they have a Google Cloud project with Calendar API enabled
  2. If not, walk them through the Google Cloud Console steps above
  3. Have them download the OAuth credentials JSON
  4. Run: gccli accounts credentials ~/path/to/credentials.json
  5. Run: gccli accounts add <email> (use --manual for browserless OAuth)

Usage

Run gccli --help for full command reference.

Common operations:

  • gccli <email> calendars - List all calendars
  • gccli <email> events <calendarId> [--from <dt>] [--to <dt>] - List events
  • gccli <email> event <calendarId> <eventId> - Get event details
  • gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> - Create event
  • gccli <email> freebusy <calendarIds> --from <dt> --to <dt> - Check availability

Use primary as calendarId for the main calendar.

Date/Time Format

  • Timed events: YYYY-MM-DDTHH:MM:SSZ (UTC) or YYYY-MM-DDTHH:MM:SS (local)
  • All-day events: YYYY-MM-DD with --all-day flag

Data Storage

  • ~/.gccli/credentials.json - OAuth client credentials
  • ~/.gccli/accounts.json - Account tokens

When not to use it

  • →When complex calendar management UI is required
  • →When performing bulk administrative calendar operations

Prerequisites

Google Cloud project with Calendar API enabledOAuth client credentials JSON file

Limitations

  • →Requires manual one-time OAuth setup
  • →Limited to CLI-based interaction

How it compares

It provides direct terminal access to calendar data instead of requiring a web browser interface.

Compared to similar skills

gccli side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
gccli (this skill)18moReviewBeginner
word269moReviewBeginner
gmail-manager273moReviewIntermediate
clawhub252moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by badlogic

View all by badlogic →

gdcli

badlogic

Google Drive CLI for listing, searching, uploading, downloading, and sharing files and folders.

13

gmcli

badlogic

Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.

13

You might also like

word

Fergana-Labs

Create, read, edit, and manipulate Microsoft Word documents (.docx files). Use when users ask to work with Word files, create documents, read .docx files, or format text documents.

26172

gmail-manager

jeffvincent

Manage Gmail - send, read, search emails, manage labels and drafts. Use when user wants to interact with their Gmail account for email operations.

27154

clawhub

openclaw

Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.

25151

agent-swarm

ruvnet

Agent skill for swarm - invoke with $agent-swarm

322

calculator

Code-and-Sorts

Performs arbitrary-precision arithmetic calculations including addition, subtraction, multiplication, division, and exponents. Use when the user asks to calculate, compute, or evaluate math expressions, or when precise decimal arithmetic is needed to avoid floating-point errors.

715

resources

windmill-labs

MUST use when managing resources.

13

Search skills

Search the agent skills registry