Agent skill · marketing growth · sundial-org
gcal-pro
Google Calendar integration for viewing, creating, and managing calendar events. Use when the user asks about their schedule, wants to add/edit/delete events, check availability, or needs a morning brief. Supports natural language like "What's on my calendar tomorrow?" or "Schedule lunch with Alex at noon Friday." Free tier provides read access; Pro tier ($12) adds create/edit/delete and morning briefs.
Why this skill is useful
Adds specific command-line scripts for managing Google Calendar events that are not commonly known or documented.
What it needs
Requires python installed locally. Requires google-cloud account access. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
gcal-pro Manage Google Calendar through natural conversation. Quick Reference Action Command Tier -------- --------- ------ View today python scripts/gcalcore.py today Free View tomorrow python scripts/gcalcore.py tomorrow Free View week python scripts/gcalcore.py week Free Search events python scripts/gcalcore.py search -q "meeting" Free List calendars python scripts/gcalcore.py calendars Free Find free time python scripts/gcalcore.py free Free Quick add python scripts/gcalcore.py quick -q "Lunch Friday noon" Pro Delete event python scripts/gcalcore.py delete --id EVENTID -y Pro Morning brief python scripts/gcalcore.py brief Pro Setup First-time setup required: 1. User must create Google Cloud project and OAuth credentials 2. Save clientsecret.json to ~/.config/gcal-pro/ 3. Run authentication: 4. Browser opens → user grants calendar access → done Check auth status: Tiers Free Tier View events (today, tomorrow, week, month) Search events List calendars Find free time slots Pro Tier ($12 one-time) Everything in Free, plus: Create events Quick add (natural language) Update/reschedule events Delete events Morning brief via cron Usage Patterns Viewing Schedule When user asks "What's on my calendar?" or "What do I have today?": For specific ranges: "tomorrow" → python scripts/gcalcore.py tomorrow "this week" → python scripts/gcalcore.py week "meetings with Alex" → python scripts/gcalcore.py search -q "Alex" Creating Events (Pro) When user says "Add X to my calendar" or "Schedule Y": Option 1: Quick add (natural language) Option 2: Structured create (via Python) Modifying Events (Pro) ⚠️ CONFIRMATION REQUIRED for destructive actions! Before deleting or significantly modifying an event, ALWAYS confirm with the user: 1. Show event details 2. Ask "Should I delete/reschedule this?" 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/gcal-pro