google-calendar

Google Calendar

Calendar management built for how small businesses actually schedule.

Uses the gws CLI for all Calendar operations. See the google-workspace skill for setup.

Triggers

• "what's on my calendar"
• "schedule a meeting"
• "check availability"
• "meeting prep"
• "cancel / reschedule a meeting"
• "block time for..."
• Any request involving scheduling, events, or availability

Prerequisites

• gws CLI installed and authenticated with Calendar scope
• Run gws auth login -s calendar if not already done

Core Commands

gws calendar +agenda             # Today's upcoming events
gws calendar +agenda --week      # This week's events
gws calendar +insert             # Create a new event
gws workflow +meeting-prep       # Prep for next meeting (attendees, docs, agenda)
gws workflow +standup-report     # Today's meetings + open tasks

Daily Scheduling Workflow

Morning: Know your day

# What's on today?
gws calendar +agenda --format table

# Full week view (Monday planning)
gws calendar +agenda --week --format table

Before each meeting: Prep

# Get attendees, description, linked docs for next meeting
gws workflow +meeting-prep

Scheduling: Create events

# Quick event from natural language
gws calendar events quickAdd --params '{"calendarId": "primary", "text": "Team standup tomorrow at 9am for 30 minutes"}'

# Structured event with attendees
gws calendar +insert

Check availability before scheduling

# Check free/busy for specific people
gws calendar freebusy query --json '{
  "timeMin": "2026-01-15T09:00:00-05:00",
  "timeMax": "2026-01-15T17:00:00-05:00",
  "items": [
    {"id": "[email protected]"},
    {"id": "[email protected]"}
  ]
}'

SMB Scheduling Patterns

Staff Meetings

# Create a recurring weekly team meeting
gws calendar events insert --params '{"calendarId": "primary"}' --json '{
  "summary": "Weekly Team Standup",
  "start": {"dateTime": "2026-01-20T09:00:00-05:00", "timeZone": "America/New_York"},
  "end": {"dateTime": "2026-01-20T09:30:00-05:00", "timeZone": "America/New_York"},
  "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
  "attendees": [
    {"email": "[email protected]"}
  ]
}'