Skip to content
alyn
badlogic

Gccli skill

Google Calendar CLI for listing calendars, viewing/creating/updating events, and checking availability.

$npx skills add badlogic/pi-skills --skill gccli
View this skill on GitHubbadlogic/pi-skills/gccli/SKILL.md
Pack stars
2,655
Pack installs
4.2k
Alyn Score
47/99
Updated
5 months ago
License
MIT
– views – installs via Alyn

badlogic

Gccli

Productivity

Install Gccli

Pick your agent. Every command is ready to paste.

$npx skills add badlogic/pi-skills --skill gccli

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads gccli when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the gccli skill”. In Codex, type $gccli.

The skill itself

SKILL.md

FolderGitHub

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

Tips for Gccli

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It is part of a pack with 8 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Gccli

What does the Gccli skill do?

Google Calendar CLI for listing calendars, viewing/creating/updating events, and checking availability.

How do I install Gccli?

Run "npx skills add badlogic/pi-skills --skill gccli" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Gccli work in Cursor and Codex?

Yes. Gccli uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Gccli free?

Gccli is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Gccli?

Gccli is published by badlogic in the badlogic/pi-skills repository, together with 7 other skills.

Similar skills. From other creators.