57 lines
2.4 KiB
Markdown
57 lines
2.4 KiB
Markdown
---
|
|
name: gog
|
|
description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
|
|
homepage: https://gogcli.sh
|
|
metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}
|
|
---
|
|
|
|
# gog
|
|
|
|
Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
|
|
|
|
Setup (once)
|
|
- `gog auth credentials /path/to/client_secret.json`
|
|
- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs`
|
|
- `gog auth list`
|
|
|
|
Common commands
|
|
- Gmail search: `gog gmail search 'newer_than:7d' --max 10`
|
|
- Gmail send: `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`
|
|
- Calendar list events: `gog calendar events <calendarId> --from <iso> --to <iso>`
|
|
- Calendar create event: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>`
|
|
- Calendar create with color: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7`
|
|
- Calendar update event: `gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4`
|
|
- Calendar show colors: `gog calendar colors`
|
|
- Drive search: `gog drive search "query" --max 10`
|
|
- Contacts: `gog contacts list --max 20`
|
|
- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`
|
|
- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
|
|
- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
|
|
- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`
|
|
- Sheets metadata: `gog sheets metadata <sheetId> --json`
|
|
- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`
|
|
- Docs cat: `gog docs cat <docId>`
|
|
|
|
Calendar Colors
|
|
- Use `gog calendar colors` to see all available event colors (IDs 1-11)
|
|
- Add colors to events with `--event-color <id>` flag
|
|
- Event color IDs (from `gog calendar colors` output):
|
|
- 1: #a4bdfc
|
|
- 2: #7ae7bf
|
|
- 3: #dbadff
|
|
- 4: #ff887c
|
|
- 5: #fbd75b
|
|
- 6: #ffb878
|
|
- 7: #46d6db
|
|
- 8: #e1e1e1
|
|
- 9: #5484ed
|
|
- 10: #51b749
|
|
- 11: #dc2127
|
|
|
|
Notes
|
|
- Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`.
|
|
- For scripting, prefer `--json` plus `--no-input`.
|
|
- Sheets values can be passed via `--values-json` (recommended) or as inline rows.
|
|
- Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
|
|
- Confirm before sending mail or creating events.
|