Google Calendar CLI

Manage Google Calendar events efficiently using the gog command-line tool.

Prerequisites

Install gog

brew install steipete/tap/gogcli

Authentication Setup

# Set up OAuth credentials
gog auth credentials /path/to/client_secret.json

# Add your Google account with calendar access
gog auth add [email protected] --services calendar

# Verify authentication
gog auth list

Quick Start

List Events

# List events from primary calendar (today's events)
gog calendar events primary --from "2026-01-01T00:00:00Z" --to "2026-01-01T23:59:59Z"

# List events for next 7 days
gog calendar events primary --from "$(date -u +%Y-%m-%dT00:00:00Z)" --to "$(date -u -v+7d +%Y-%m-%dT23:59:59Z)"

Create Event

# Create a basic event
gog calendar create primary --summary "Team Meeting" --from "2026-01-15T14:00:00+01:00" --to "2026-01-15T15:00:00+01:00"

# Create with color
gog calendar create primary --summary "Important Deadline" --from "2026-01-20T00:00:00+01:00" --to "2026-01-20T23:59:59+01:00" --event-color 11

Update Event

# Update event title and color
gog calendar update primary \x3CeventId> --summary "Updated Meeting Title" --event-color 4

Event Colors

# View all colors
gog calendar colors

Common Workflows

Find Available Time Slots

# List all events to visualize availability
gog calendar events primary --from "2026-01-15T00:00:00Z" --to "2026-01-21T23:59:59Z" --json

Schedule Recurring Concept

Note: gog CLI doesn't support direct recurring events, but you can script them:

# Create multiple events via scripting (example)
for i in {1..5}; do
  DATE=$(date -v+${i}d +%Y-%m-%d)
  gog calendar create primary --summary "Daily Standup" \
    --from "${DATE}T09:00:00+01:00" --to "${DATE}T09:30:00+01:00" \
    --event-color 1
done

Bulk Operations

# Set default account to avoid repetition
export [email protected]

# Then run commands without --account
gog calendar events primary --from "..." --to "..."

Tips for Effective Use

1. Use ISO 8601 timestamps: Always include timezone offset
2. JSON output for scripting: Add --json flag for machine-readable output
3. Batch with --no-input: Use --no-input for automated scripts
4. Primary calendar shortcut: Use "primary" as the calendar ID for your main calendar

Example Script: Weekly Agenda Check

#!/bin/bash
# Get this week's events
START=$(date -u -v-Monday +%Y-%m-%dT00:00:00Z)
END=$(date -u -v+Sunday +%Y-%m-%dT23:59:59Z)
gog calendar events primary --from "$START" --to "$END" --json