google-calendar-automation

# Google Calendar Lightweight Google Calendar integration with standalone OAuth authentication. No MCP server required. > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported. ## When to Use - You need to list, create, inspect, or update Google Calendar events from local scripts. - The task requires OAuth-backed calendar automation without standing up an MCP server. - You need quick operational access to calendars, schedules, attendees, or event details in a Workspace environment. ## First-Time Setup Authenticate with Google (opens browser): ```bash python scripts/auth.py login ``` Check authentication status: ```bash python scripts/auth.py status ``` Logout when needed: ```bash python scripts/auth.py logout ``` ## Commands All operations via `scripts/gcal.py`. Auto-authenticates on first use if not logged in. ### List Calendars ```bash python scripts/gcal.py list-calendars ``` ### List Events ```bash # List events from primary calendar (default: next 30 days) python scripts/gcal.py list-events # List events with specific time range python scripts/gcal.py list-events --time-min 2024-01-15T00:00:00Z --time-max 2024-01-31T23:59:59Z # List events from a specific calendar python scripts/gcal.py list-events --calendar "work@example.com" # Limit results python scripts/gcal.py list-events --max-results 10 ``` ### Get Event Details ```bash python scripts/gcal.py get-event EVENT_ID python scripts/gcal.py get-event EVENT_ID --calendar "wor...