Agent skill · writing content · sundial-org
gcalcli
Interact with Google Calendar via gcalcli
Why this skill is useful
Provides specific commands and usage patterns for a custom fork of gcalcli that enhances Google Calendar interactions, which the AI wouldn't reliably generate on its own.
What it needs
Requires uvx installed locally. Requires google account access. About 6k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Calendar Reference This document provides details on using gcalcli to view and manage calendar events. Installation gcalcli is a Python CLI for Google Calendar that works with uvx for one-time execution. IMPORTANT: Always use the custom fork with attachment support: This custom version includes attachments in TSV and JSON output, which is essential for accessing meeting notes and other event attachments. Authentication First time running gcalcli, it will: 1. Open a browser for Google OAuth authentication 2. Cache credentials for future use 3. Request calendar read permissions Common Commands View Upcoming Agenda Recommended: JSON format with full details (structured data with attachments): Alternative: TSV format (tab-separated, parseable): Human-readable format (may truncate long descriptions): Basic agenda view (minimal details): Date Ranges Important: gcalcli agenda shows events from NOW onwards by default. When you run gcalcli agenda "today" at 2pm, it shows events from 2pm onwards for today and into the future. Past events from earlier today won't appear. Specific date range: Today only (from current time onwards): See earlier today's events (use absolute dates): Next week: Search Calendar Search for events by text: Access Meeting Attachments and Gemini Notes IMPORTANT: The custom gcalcli fork includes attachments array in JSON/TSV output. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/gcalcli