821 Calendar Abef4156

Calendar Operations Reference

Comprehensive guide to Google Calendar operations with gog.

Listing Calendars

# List all calendars
gog calendar calendars

# JSON output
gog calendar calendars --json

Listing Events

# List events from primary calendar
gog calendar events primary

# List from specific calendar
gog calendar events work@group.calendar.google.com

# Filter by date range
gog calendar events primary --from 2024-12-01T00:00:00Z --to 2024-12-31T23:59:59Z

# Natural date formats also work
gog calendar events primary --from "2024-12-01" --to "2024-12-31"

# Search events
gog calendar events primary --query "meeting"

# Show weekday
gog calendar events primary --weekday

# Limit results
gog calendar events primary --max 10

# Paginate
gog calendar events primary --page <nextPageToken>

Getting Event Details

gog calendar event primary <eventId>
gog calendar get primary <eventId>

Creating Events

Basic Event

gog calendar create primary \
  --summary "Team Meeting" \
  --from "2024-12-20T14:00:00" \
  --to "2024-12-20T15:00:00"

With Details

gog calendar create primary \
  --summary "Project Review" \
  --description "Quarterly review of project progress" \
  --location "Conference Room A" \
  --from "2024-12-20T14:00:00" \
  --to "2024-12-20T15:00:00"

With Attendees

gog calendar create primary \
  --summary "Team Sync" \
  --from "2024-12-20T14:00:00" \
  --to "2024-12-20T15:00:00" \
  --attendees "alice@example.com,bob@example.com"

All-Day Event

gog calendar create primary \
  --summary "Company Holiday" \
  --from "2024-12-25" \
  --to "2024-12-26" \
  --all-day

With Recurrence

# Weekly meeting
gog calendar create primary \
  --summary "Weekly Standup" \
  --from "2024-12-20T09:00:00" \
  --to "2024-12-20T09:30:00" \
  --rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR"

# Monthly meeting
gog calendar create primary \
  --summary "Monthly Review" \
  --from "2024-12-01T10:00:00" \
  --to "2024-12-01T11:00:00" \
  --rrule "FREQ=MONTHLY;BYMONTHDAY=1"

With Reminders

gog calendar create primary \
  --summary "Important Meeting" \
  --from "2024-12-20T14:00:00" \
  --to "2024-12-20T15:00:00" \
  --reminders "10m,1h,1d"

Updating Events

# Update summary
gog calendar update primary <eventId> --summary "Updated Title"

# Update time
gog calendar update primary <eventId> \
  --from "2024-12-20T15:00:00" \
  --to "2024-12-20T16:00:00"

# Update multiple fields
gog calendar update primary <eventId> \
  --summary "New Title" \
  --description "Updated description" \
  --location "New Location"

# Add attendee (preserves existing)
gog calendar update primary <eventId> --add-attendee "new@example.com"

# Replace all attendees
gog calendar update primary <eventId> --attendees "only@example.com"

Deleting Events

gog calendar delete primary <eventId>

Responding to Events

# Accept invitation
gog calendar respond primary <eventId> --status accepted

# Decline
gog calendar respond primary <eventId> --status declined

# Tentative
gog calendar respond primary <eventId> --status tentative

# Control notification sending
gog calendar respond primary <eventId> \
  --status accepted \
  --send-updates all          # all, none, externalOnly

Checking Availability

# Check free/busy for calendars
gog calendar freebusy "primary,work@group.calendar.google.com" \
  --from "2024-12-20T08:00:00Z" \
  --to "2024-12-20T18:00:00Z"

Proposing Alternative Times

gog calendar propose-time primary <eventId> \
  --from "2024-12-21T14:00:00" \
  --to "2024-12-21T15:00:00"

Special Event Types

Focus Time

gog calendar focus-time create primary \
  --from "2024-12-20T09:00:00" \
  --to "2024-12-20T12:00:00" \
  --summary "Deep Work" \
  --auto-decline

Out of Office

gog calendar ooo create primary \
  --from "2024-12-20T00:00:00" \
  --to "2024-12-27T00:00:00" \
  --summary "Holiday" \
  --decline-message "I'm away until Dec 27"

Working Location

# Office
gog calendar working-location create primary \
  --from "2024-12-20T09:00:00" \
  --to "2024-12-20T17:00:00" \
  --location office \
  --building "HQ" \
  --floor "3" \
  --desk "3-42"

# Home
gog calendar working-location create primary \
  --from "2024-12-20T09:00:00" \
  --to "2024-12-20T17:00:00" \
  --location home

# Custom
gog calendar working-location create primary \
  --from "2024-12-20T09:00:00" \
  --to "2024-12-20T17:00:00" \
  --location custom \
  --custom-location "Client Site"

Calendar Colours

gog calendar colors

Team Calendars

# View team calendar
gog calendar team team@group.calendar.google.com

# Filter by date range
gog calendar team team@group.calendar.google.com \
  --from "2024-12-01" \
  --to "2024-12-31"

Conflict Detection

gog calendar conflicts primary \
  --from "2024-12-20T00:00:00Z" \
  --to "2024-12-27T00:00:00Z"

Workspace Users

# List workspace users (for scheduling)
gog calendar users
gog calendar users --max 50

Access Control

# List calendar ACLs
gog calendar acl primary
gog calendar acl work@group.calendar.google.com

Time Formats

Commands accept various time formats:

The default timezone can be configured:

# Set default timezone
gog config set default_timezone America/New_York

# Or via environment
export GOG_TIMEZONE=Europe/London

# Or per-command
gog time now --timezone Asia/Tokyo

Scripting Examples

Find Available Slots

# Get free/busy and parse with jq
gog calendar freebusy "user1@example.com,user2@example.com" \
  --from "2024-12-20T08:00:00Z" \
  --to "2024-12-20T18:00:00Z" \
  --json | jq '.calendars'

Batch Create Events

# Create events from a file
while IFS=$'\t' read -r summary from to; do
  gog calendar create primary \
    --summary "$summary" \
    --from "$from" \
    --to "$to"
done < events.tsv

Export Events

# Export events to JSON
gog calendar events primary \
  --from "2024-12-01" \
  --to "2024-12-31" \
  --json > december-events.json