# 821 Calendar Abef4156 > Calendar Operations Reference - Skill: `tools-only/821-calendar-abef4156` (Agent Skill, multi-file: 3 files) - Install (CLI): `npx skillmds@latest add tools-only/821-calendar-abef4156` - Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/821-calendar-abef4156/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tools-only (https://skillmd.com/u/tools-only) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/tools-only/821-calendar-abef4156 --- # Calendar Operations Reference Comprehensive guide to Google Calendar operations with `gog`. ## Listing Calendars ```bash # List all calendars gog calendar calendars # JSON output gog calendar calendars --json ``` ## Listing Events ```bash # 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 ``` --- ## Getting Event Details ```bash gog calendar event primary gog calendar get primary ``` --- ## Creating Events ### Basic Event ```bash gog calendar create primary \ --summary "Team Meeting" \ --from "2024-12-20T14:00:00" \ --to "2024-12-20T15:00:00" ``` ### With Details ```bash 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 ```bash 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 ```bash gog calendar create primary \ --summary "Company Holiday" \ --from "2024-12-25" \ --to "2024-12-26" \ --all-day ``` ### With Recurrence ```bash # 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 ```bash 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 ```bash # Update summary gog calendar update primary --summary "Updated Title" # Update time gog calendar update primary \ --from "2024-12-20T15:00:00" \ --to "2024-12-20T16:00:00" # Update multiple fields gog calendar update primary \ --summary "New Title" \ --description "Updated description" \ --location "New Location" # Add attendee (preserves existing) gog calendar update primary --add-attendee "new@example.com" # Replace all attendees gog calendar update primary --attendees "only@example.com" ``` --- ## Deleting Events ```bash gog calendar delete primary ``` --- ## Responding to Events ```bash # Accept invitation gog calendar respond primary --status accepted # Decline gog calendar respond primary --status declined # Tentative gog calendar respond primary --status tentative # Control notification sending gog calendar respond primary \ --status accepted \ --send-updates all # all, none, externalOnly ``` --- ## Checking Availability ```bash # 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 ```bash gog calendar propose-time primary \ --from "2024-12-21T14:00:00" \ --to "2024-12-21T15:00:00" ``` --- ## Special Event Types ### Focus Time ```bash 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 ```bash 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 ```bash # 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 ```bash gog calendar colors ``` --- ## Team Calendars ```bash # 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 ```bash gog calendar conflicts primary \ --from "2024-12-20T00:00:00Z" \ --to "2024-12-27T00:00:00Z" ``` --- ## Workspace Users ```bash # List workspace users (for scheduling) gog calendar users gog calendar users --max 50 ``` --- ## Access Control ```bash # List calendar ACLs gog calendar acl primary gog calendar acl work@group.calendar.google.com ``` --- ## Time Formats Commands accept various time formats: | Format | Example | |--------|---------| | RFC3339 | `2024-12-20T14:00:00Z` | | RFC3339 with offset | `2024-12-20T14:00:00-05:00` | | Date only | `2024-12-20` | | ISO datetime | `2024-12-20T14:00:00` | The default timezone can be configured: ```bash # 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 ```bash # 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 ```bash # 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 ```bash # Export events to JSON gog calendar events primary \ --from "2024-12-01" \ --to "2024-12-31" \ --json > december-events.json ```