This skill assumes gog is installed and authorised. If commands fail with authentication errors, inform the user they need to:

1. Install gog: brew install steipete/tap/gogcli
2. Store OAuth credentials: gog auth credentials
3. Add account: gog auth add user@gmail.com --services all

Do not attempt to resolve authentication issues automatically. Provide the user with the relevant command and let them handle it.

Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat (Workspace), Classroom, Contacts, Tasks, People, Groups (Workspace), Keep (Workspace, service account only).

Global Flags

```bash

--account # Select account

--client # Select OAuth client

--json # JSON output

--plain # TSV output (for scripting)

--force # Skip confirmations

--no-input # Fail instead of prompting

```

Common Patterns

```bash

gog --account work@example.com gmail search "is:unread" # Use specific account

gog gmail search "is:unread" --json | jq '.threads[].id' # JSON for parsing

gog gmail search "is:unread" --plain | cut -f1 # Plain for shell

gog gmail search "is:unread" --max 10 --page # Pagination

```

Search and Read

```bash

gog gmail search "is:unread from:boss@example.com newer_than:7d"

gog gmail messages search "is:unread" --include-body

gog gmail thread get

gog gmail get --format full

```

Send Email

```bash

# Basic send

gog gmail send --to user@example.com --subject "Hello" --body "Message"

# With HTML and attachments

gog gmail send --to user@example.com --subject "Report" \

--body-html "

Report

# Reply

gog gmail send --to user@example.com --subject "Re: Original" \

--body "Reply" --reply-to-message-id

```

Labels

```bash

gog gmail labels list

gog gmail labels create "Project/Subproject"

gog gmail thread modify --add "Label" --remove INBOX

```

For full Gmail reference including drafts, filters, vacation, delegates, tracking, and watch, see references/gmail.md.

Events

```bash

gog calendar events primary --from "2024-12-01" --to "2024-12-31" --weekday

gog calendar events primary --query "meeting"

# Create event

gog calendar create primary --summary "Meeting" \

--from "2024-12-20T14:00:00" --to "2024-12-20T15:00:00"

# With attendees and recurrence

gog calendar create primary --summary "Weekly Standup" \

--from "2024-12-20T09:00:00" --to "2024-12-20T09:30:00" \

--attendees "alice@example.com,bob@example.com" \

--rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR"

# Respond

gog calendar respond primary --status accepted

```

Special Event Types

```bash

gog calendar focus-time create primary --from DT --to DT --auto-decline

gog calendar ooo create primary --from DT --to DT --decline-message "Away"

gog calendar working-location create primary --from DT --to DT --location home

```

For full Calendar reference, see references/calendar.md.

Drive

```bash

gog drive ls --parent

gog drive search "quarterly report"

gog drive download --out ~/Downloads/

gog drive upload ~/report.pdf --parent

gog drive mkdir "New Folder" --parent

gog drive share --email user@example.com --role writer

```

Sheets

```bash

gog sheets read "Sheet1!A1:D10"

gog sheets write "Sheet1!A1:B2" --values '[["Name","Age"],["Alice",30]]'

gog sheets append "Sheet1!A:B" --values '[["Bob",25]]'

gog sheets format "Sheet1!A1:D1" --bold --bg-color "#FFCC00"

```

Export

```bash

gog docs export --format pdf --out ~/doc.pdf

gog slides export --format pptx --out ~/slides.pptx

```

For full Drive/Docs/Sheets/Slides reference, see references/drive-docs.md.

```bash

gog tasks lists

gog tasks list

gog tasks add --title "Buy groceries" --due "2024-12-20"

gog tasks add --title "Weekly review" --due "2024-12-20" --repeat weekly

gog tasks done

```

```bash

gog contacts search "john"

gog contacts create --given "John" --family "Doe" --email "john@example.com"

gog contacts directory search "smith" # Workspace

```

```bash

gog classroom courses --state ACTIVE

gog classroom students

gog classroom coursework create --title "Homework" --type ASSIGNMENT --due "2024-12-31T23:59:59Z"

gog classroom submissions grade --grade 95

```

For Classroom, Chat, Contacts, Tasks, People, Groups, Keep, see references/other-services.md.

Config Locations

• macOS: ~/Library/Application Support/gogcli/config.json
• Linux: ~/.config/gogcli/config.json
• Windows: %AppData%\gogcli\config.json

Settings

```bash

gog config set default_timezone America/New_York

gog config set default_account user@gmail.com

gog config list

```

Environment Variables

```bash

GOG_ACCOUNT=user@gmail.com # Default account

GOG_CLIENT=work # OAuth client

GOG_JSON=1 # Default JSON output

GOG_PLAIN=1 # Default plain output

GOG_TIMEZONE=America/New_York # Display timezone

GOG_ENABLE_COMMANDS=calendar,tasks # Command allowlist

```

For full configuration, see references/configuration.md.

```bash

gog --account work@example.com gmail search "is:unread"

gog auth alias set work work@example.com

gog --account work gmail search "is:unread"

gog auth list --check

```

For authentication including service accounts, see references/authentication.md.

```bash

# JSON processing

gog gmail search "is:unread" --json | jq -r '.threads[].id'

# Batch operations

gog gmail search "older_than:30d" --json | \

jq -r '.threads[].id' | \

xargs -I {} gog gmail thread modify {} --add Archive --remove INBOX

# Non-interactive

gog gmail send --to user@example.com --subject "Test" --body "Hi" --force

```

If commands fail, inform the user of the likely cause:

| Error | Cause | Solution |

|-------|-------|----------|

| no credentials | OAuth not configured | gog auth credentials |

| token expired | Auth invalid | gog auth add --force-consent |

| insufficient scope | Missing permissions | gog auth add --services |

| command not found | Not installed | brew install steipete/tap/gogcli |

Status checks:

```bash

gog auth list --check

gog auth status

```

• references/command-reference.md - Complete command specification
• references/authentication.md - Auth, credentials, multi-account
• references/configuration.md - Config and environment variables
• references/gmail.md - Gmail operations
• references/calendar.md - Calendar operations
• references/drive-docs.md - Drive, Docs, Sheets, Slides
• references/other-services.md - Classroom, Chat, Contacts, Tasks, People, Groups, Keep