gcal-proGoogle 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.
Install via ClawdBot CLI:
clawdbot install bilalmohamed187-cpu/gcal-proManage Google Calendar through natural conversation.
| Action | Command | Tier |
|--------|---------|------|
| View today | python scripts/gcal_core.py today | Free |
| View tomorrow | python scripts/gcal_core.py tomorrow | Free |
| View week | python scripts/gcal_core.py week | Free |
| Search events | python scripts/gcal_core.py search -q "meeting" | Free |
| List calendars | python scripts/gcal_core.py calendars | Free |
| Find free time | python scripts/gcal_core.py free | Free |
| Quick add | python scripts/gcal_core.py quick -q "Lunch Friday noon" | Pro |
| Delete event | python scripts/gcal_core.py delete --id EVENT_ID -y | Pro |
| Morning brief | python scripts/gcal_core.py brief | Pro |
First-time setup required:
client_secret.json to ~/.config/gcal-pro/
python scripts/gcal_auth.py authCheck auth status:
python scripts/gcal_auth.py statusWhen user asks "What's on my calendar?" or "What do I have today?":
cd /path/to/gcal-pro
python scripts/gcal_core.py todayFor 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_datetime
create_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 or -y flag after user confirmsDelete:
# First, find the event
python scripts/gcal_core.py search -q "dentist"
# Shows event ID
# Then delete (with user confirmation)
python scripts/gcal_core.py delete --id abc123xyz -yWhen user asks "When am I free?" or "Find time for a 1-hour meeting":
python scripts/gcal_core.py freeSet 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 python scripts/gcal_auth.py auth --force |
| "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 StFor confirmations:
ā Event created: "Lunch with Alex"
š
Friday, Jan 31 at 12:00 PM
š Cafe RomaFor morning brief:
āļø Good morning! Here's your day:
š Monday, January 27, 2026
You 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?
Generated Mar 1, 2026
A freelance consultant uses gcal-pro to view daily and weekly schedules, search for client meetings, and quickly add new appointments via natural language. The morning brief feature helps them start each day organized, while free time detection assists in scheduling new work sessions without conflicts.
A small business team employs gcal-pro to share calendar views, find common free slots for meetings, and manage event creation and updates. The Pro tier enables collaborative scheduling and automated morning briefs sent via messaging apps to keep everyone aligned on daily agendas.
An individual uses gcal-pro to manage personal appointments, set reminders for tasks like doctor visits or social events, and receive daily briefs via cron. The natural language quick-add feature simplifies input, while error handling ensures reliable access even with token issues.
An event planner utilizes gcal-pro to schedule vendor meetings, track event timelines, and send briefs to clients. The Pro tier allows creating and modifying events efficiently, with confirmation prompts preventing accidental deletions, ensuring smooth coordination across multiple calendars.
Remote workers rely on gcal-pro to view schedules across time zones, search for specific meetings, and integrate briefs into their morning routine via cron. The timezone handling ensures accurate scheduling, while the free tier provides essential read access for basic calendar management.
Offers a free tier for read-only calendar access and a Pro tier with a one-time $12 fee for write capabilities and advanced features like morning briefs. This model attracts users with basic needs and converts them to paying customers for enhanced functionality.
Monetizes by integrating with platforms like Clawdbot, where users pay for cron scheduling and messaging delivery of morning briefs. The skill acts as a value-add, driving sales through complementary services and enhanced user experiences.
Targets businesses by offering customized versions with additional features such as multi-user support, advanced analytics, or API access. Revenue comes from licensing fees or tailored development projects based on organizational needs.
š¬ Integration Tip
Leverage cron jobs for automated morning briefs and integrate with messaging platforms to deliver updates directly to users, enhancing engagement and utility.
Interact with Google Calendar via the Google Calendar API ā list upcoming events, create new events, update or delete them. Use this skill when you need programmatic access to your calendar from OpenClaw.
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar events, or scheduling.
Google Calendar via gcalcli: today-only agenda by default, bounded meaning-first lookup via agenda scans, and fast create/delete with verification--optimized for low tool calls and minimal output.
This skill should be used when interacting with Apple Calendar on macOS. Use it for listing calendars, viewing events, creating/updating/deleting calendar events, and checking availability/free-busy times. Triggers on requests like "check my calendar", "schedule a meeting", "what's on my schedule", "am I free tomorrow", or any calendar-related operations.
Access and manage Google Calendar events with gogcli for cross-calendar agendas, keyword search, and filtered outputs avoiding unwanted calendars like holidays.
Daily morning rollup of important emails and calendar events at 8am with AI-generated summaries