calendar

odysseus0's avatarfrom odysseus0

Google Calendar management via CLI. Use when user mentions calendar, events, scheduling, appointments, meetings, free/busy time, or checking availability. Supports listing calendars, viewing/creating/updating/deleting events, and checking free/busy status.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 7, 2026
[Meeting Productivity]

When & Why to Use This Skill

This Claude skill provides comprehensive Google Calendar management via a CLI integration, enabling users to list, create, update, and delete events. It streamlines scheduling workflows by allowing for quick availability checks and event searching, making it an essential tool for enhancing meeting productivity and personal time management through automated agentic actions.

Use Cases

  • Case 1: Automated Meeting Creation - Effortlessly schedule team syncs, set descriptions, and invite attendees using natural language commands that trigger CLI actions.
  • Case 2: Real-time Availability Checking - Quickly query free/busy status for specific date ranges to identify the best time slots for new appointments or client calls.
  • Case 3: Efficient Event Search and Updates - Locate specific meetings using query strings and modify event details like titles, locations, or times on the fly without opening a browser.
  • Case 4: Multi-Calendar Oversight - List and manage various calendars associated with an account to maintain a clear view of both personal and professional commitments.
namecalendar
descriptionGoogle Calendar management via CLI. Use when user mentions calendar, events, scheduling, appointments, meetings, free/busy time, or checking availability. Supports listing calendars, viewing/creating/updating/deleting events, and checking free/busy status.

Calendar

Google Calendar access via gccli CLI.

Account

georgezhangtj97@gmail.com

Essential Commands

# List calendars
gccli georgezhangtj97@gmail.com calendars

# List upcoming events (default: next week)
gccli georgezhangtj97@gmail.com events primary

# Events with date range
gccli georgezhangtj97@gmail.com events primary --from 2026-01-15T00:00:00 --to 2026-01-20T00:00:00

# Search events
gccli georgezhangtj97@gmail.com events primary --query "meeting"

# Get event details
gccli georgezhangtj97@gmail.com event primary <eventId>

Creating Events

# Standard event
gccli georgezhangtj97@gmail.com create primary \
  --summary "Meeting" \
  --start 2026-01-15T10:00:00 \
  --end 2026-01-15T11:00:00

# All-day event
gccli georgezhangtj97@gmail.com create primary \
  --summary "Vacation" \
  --start 2026-01-20 \
  --end 2026-01-25 \
  --all-day

# With details
gccli georgezhangtj97@gmail.com create primary \
  --summary "Team Sync" \
  --start 2026-01-15T14:00:00 \
  --end 2026-01-15T15:00:00 \
  --description "Weekly sync" \
  --location "Conference Room A" \
  --attendees "alice@example.com,bob@example.com"

Modifying Events

# Update
gccli georgezhangtj97@gmail.com update primary <eventId> --summary "New Title"

# Delete
gccli georgezhangtj97@gmail.com delete primary <eventId>

Free/Busy

gccli georgezhangtj97@gmail.com freebusy primary --from 2026-01-15T00:00:00Z --to 2026-01-16T00:00:00Z

Notes

  • primary is the main calendar; use calendar ID from calendars command for others
  • Datetimes: ISO 8601 format (local time or with Z for UTC)
  • All-day events: use YYYY-MM-DD format with --all-day flag