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 br
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Manage Google Calendar through natural conversation.
| Action | Command | Tier |
|---|---|---|
| View today | | Free |
| View tomorrow | | Free |
| View week | | Free |
| Search events | | Free |
| List calendars | | Free |
| Find free time | | Free |
| Quick add | | Pro |
| Delete event | | Pro |
| Morning brief | | Pro |
First-time setup required:
client_secret.json~/.config/gcal-pro/python scripts/gcal_auth.py auth
Check auth status:
python scripts/gcal_auth.py status
When user asks "What's on my calendar?" or "What do I have today?":
cd /path/to/gcal-pro python scripts/gcal_core.py today
For specific ranges:
python scripts/gcal_core.py tomorrowpython scripts/gcal_core.py weekpython scripts/gcal_core.py search -q "Alex"When user says "Add X to my calendar" or "Schedule Y":
Option 1: Quick add (natural language)
python scripts/gcal_core.py quick -q "Lunch with Alex Friday at noon"
Option 2: Structured create (via Python)
from scripts.gcal_core import create_event, parse_datetimecreate_event( summary="Lunch with Alex", start=parse_datetime("Friday noon"), location="Cafe Roma", confirmed=True # Set False to show confirmation prompt )
⚠️ CONFIRMATION REQUIRED for destructive actions!
Before deleting or significantly modifying an event, ALWAYS confirm with the user:
confirmed=True-yDelete:
# First, find the event python scripts/gcal_core.py search -q "dentist" # Shows event IDThen delete (with user confirmation)
python scripts/gcal_core.py delete --id abc123xyz -y
When user asks "When am I free?" or "Find time for a 1-hour meeting":
python scripts/gcal_core.py free
Set up via Clawdbot cron to send daily agenda:
from scripts.gcal_core import generate_morning_brief print(generate_morning_brief())
Cron setup example:
python scripts/gcal_core.py brief| Error | Cause | Solution |
|---|---|---|
| "client_secret.json not found" | Setup incomplete | Complete Google Cloud setup |
| "Token refresh failed" | Expired/revoked | Run |
| "requires Pro tier" | Free user attempting write | Prompt upgrade or explain limitation |
| "Event not found" | Invalid event ID | Search for correct event first |
For event lists, use this format:
📅 **Monday, January 27** • 9:00 AM — Team standup • 12:00 PM — Lunch with Alex 📍 Cafe Roma • 3:00 PM — Client call📅 Tuesday, January 28 • 10:00 AM — Dentist appointment 📍 123 Main St
For confirmations:
✓ Event created: "Lunch with Alex" 📅 Friday, Jan 31 at 12:00 PM 📍 Cafe Roma
For morning brief:
☀️ Good morning! Here's your day: 📆 Monday, January 27, 2026You have 3 events today: • 9:00 AM — Team standup • 12:00 PM — Lunch with Alex • 3:00 PM — Client call
👀 Tomorrow: 2 events
~/.config/gcal-pro/ ├── client_secret.json # OAuth app credentials (user provides) ├── token.json # User's access token (auto-generated) └── license.json # Pro license (if purchased)
This skill works with:
When a Free user attempts a Pro action, respond:
⚠️ Creating events requires gcal-pro Pro ($12 one-time).
Pro includes: Create, edit, delete events + morning briefs.
👉 Upgrade: [gumroad-link]
For now, I can show you your schedule (free) — want to see today's events?
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.