gog
Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
Setup (once)
/skill install gog gog selects Homebrew on macOS or Go on Linux. Linux
requires a Go toolchain supported by the pinned gog release and its install
location (GOBIN, or GOPATH/bin, normally ~/go/bin) on the gateway's
PATH. For cloud deployments, provision gog in the runtime image. Host
installation does not install binaries inside separate agent containers.
hybridclaw skill install gog gog
hybridclaw auth login google --client-id <id> --client-secret <secret> --account you@gmail.com
hybridclaw auth status google
HybridClaw stores the Google OAuth client secret and refresh token in encrypted runtime secrets, mints a short-lived access token on the host, and injects only GOG_ACCESS_TOKEN, GOOGLE_WORKSPACE_CLI_TOKEN, and GOG_ACCOUNT into the agent runtime for Google Workspace CLIs.
Common commands
gog supports the commands: calendar, chat, contacts, docs, drive, forms, gmail, groups, people,
slides, tasks, sheets
Help about a gog command: gog <command> --help
Gmail search: gog gmail search 'newer_than:7d' --max 10
Gmail messages search (per email, ignores threading): gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
Gmail send (plain): gog gmail send --to a@b.com --subject "Hi" --body "Hello"
Gmail send (multi-line): gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send (stdin): gog gmail send --to a@b.com --subject "Hi" --body-file -
Gmail send (HTML): gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"
Gmail draft: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send draft: gog gmail drafts send <draftId>
Gmail reply: gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>
Calendar search events: gog calendar search <calendarId> "Meeting" --from <iso> --to <iso> --max 10
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 attendees: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --attendees a@b.com,c@d.com --send-updates all
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
Email Formatting
Prefer plain text. Use --body-file for multi-paragraph messages (or --body-file - for stdin).
Same --body-file pattern works for drafts and replies.
--body does not unescape \n. If you need inline newlines, use a heredoc or $'Line 1\n\nLine 2'.
Use --body-html only when you need rich formatting.
HTML tags: <p> for paragraphs, <br> for line breaks, <strong> for bold, <em> for italic, <a href="url"> for links, <ul>/<li> for lists.
Example (plain text via stdin):
gog gmail send --to recipient@example.com \
--subject "Meeting Follow-up" \
--body-file - <<'EOF'
Hi Name,
Thanks for meeting today. Next steps:
- Item one
- Item two
Best regards,
Your Name
EOF
Example (HTML list):
gog gmail send --to recipient@example.com \
--subject "Meeting Follow-up" \
--body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"
Notes
- For scripting, prefer
--json plus --no-input.
- When the user asks for calendar events without naming a calendar ID,
gog searches all available calendars.
- Do not pipe
gog ... --json through ad hoc Python filters unless the JSON shape has been inspected first.
- 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.
gog gmail search returns one row per thread; use gog gmail messages search when you need every individual email returned separately.
1---2name: gog3description: Google Workspace CLI for Gmail, Google Calendar events, meetings, schedules, availability, Drive, Contacts, Sheets, and Docs4user-invocable: true5requires:6 bins:7 - gog8metadata:9 source: https://skillmd.com/skills/hybridaione/gog10 hybridclaw:11 category: productivity12 short_description: "Google Workspace via gog CLI."13 tags:14 - google15 - workspace16 - gmail17 - calendar18 - drive19 - sheets20 - docs21 related_skills:22 - google-workspace23 install:24 - id: gog25 kind: brew26 os: ["darwin"]27 formula: openclaw/tap/gogcli28 bins: ["gog"]29 label: Install gog CLI (brew)30 - id: gog31 kind: go32 os: ["linux"]33 # 2026-09-24 (installer implementation): pin the verified upstream release; image provisioning is separate.34 module: github.com/openclaw/gogcli/cmd/gog@v0.41.035 bins: ["gog"]36 label: Install gog CLI (Go)37---3839# gog4041Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.4243## Setup (once)4445`/skill install gog gog` selects Homebrew on macOS or Go on Linux. Linux46requires a Go toolchain supported by the pinned gog release and its install47location (`GOBIN`, or `GOPATH/bin`, normally `~/go/bin`) on the gateway's48`PATH`. For cloud deployments, provision gog in the runtime image. Host49installation does not install binaries inside separate agent containers.5051```bash52hybridclaw skill install gog gog53hybridclaw auth login google --client-id <id> --client-secret <secret> --account you@gmail.com54hybridclaw auth status google55```5657HybridClaw stores the Google OAuth client secret and refresh token in encrypted runtime secrets, mints a short-lived access token on the host, and injects only `GOG_ACCESS_TOKEN`, `GOOGLE_WORKSPACE_CLI_TOKEN`, and `GOG_ACCOUNT` into the agent runtime for Google Workspace CLIs.5859## Common commands6061`gog` supports the commands: calendar, chat, contacts, docs, drive, forms, gmail, groups, people,62slides, tasks, sheets6364- Help about a gog command: `gog <command> --help`6566- Gmail search: `gog gmail search 'newer_than:7d' --max 10`67- Gmail messages search (per email, ignores threading): `gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com`68- Gmail send (plain): `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`69- Gmail send (multi-line): `gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt`70- Gmail send (stdin): `gog gmail send --to a@b.com --subject "Hi" --body-file -`71- Gmail send (HTML): `gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"`72- Gmail draft: `gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt`73- Gmail send draft: `gog gmail drafts send <draftId>`74- Gmail reply: `gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>`75- Calendar search events: `gog calendar search <calendarId> "Meeting" --from <iso> --to <iso> --max 10`76- Calendar list events: `gog calendar events <calendarId> --from <iso> --to <iso>`77- Calendar create event: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>`78- Calendar create with attendees: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --attendees a@b.com,c@d.com --send-updates all`79- Calendar create with color: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7`80- Calendar update event: `gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4`81- Calendar show colors: `gog calendar colors`82- Drive search: `gog drive search "query" --max 10`83- Contacts: `gog contacts list --max 20`84- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`85- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`86- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`87- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`88- Sheets metadata: `gog sheets metadata <sheetId> --json`89- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`90- Docs cat: `gog docs cat <docId>`9192## Calendar Colors9394- Use `gog calendar colors` to see all available event colors (IDs 1-11)95- Add colors to events with `--event-color <id>` flag96- Event color IDs (from `gog calendar colors` output):97 - 1: #a4bdfc98 - 2: #7ae7bf99 - 3: #dbadff100 - 4: #ff887c101 - 5: #fbd75b102 - 6: #ffb878103 - 7: #46d6db104 - 8: #e1e1e1105 - 9: #5484ed106 - 10: #51b749107 - 11: #dc2127108109Email Formatting110111- Prefer plain text. Use `--body-file` for multi-paragraph messages (or `--body-file -` for stdin).112- Same `--body-file` pattern works for drafts and replies.113- `--body` does not unescape `\n`. If you need inline newlines, use a heredoc or `$'Line 1\n\nLine 2'`.114- Use `--body-html` only when you need rich formatting.115- HTML tags: `<p>` for paragraphs, `<br>` for line breaks, `<strong>` for bold, `<em>` for italic, `<a href="url">` for links, `<ul>`/`<li>` for lists.116- Example (plain text via stdin):117118 ```bash119 gog gmail send --to recipient@example.com \120 --subject "Meeting Follow-up" \121 --body-file - <<'EOF'122 Hi Name,123124 Thanks for meeting today. Next steps:125 - Item one126 - Item two127128 Best regards,129 Your Name130 EOF131 ```132133- Example (HTML list):134 ```bash135 gog gmail send --to recipient@example.com \136 --subject "Meeting Follow-up" \137 --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"138 ```139140## Notes141- For scripting, prefer `--json` plus `--no-input`.142- When the user asks for calendar events without naming a calendar ID, `gog` searches all available calendars.143- Do not pipe `gog ... --json` through ad hoc Python filters unless the JSON shape has been inspected first.144- Sheets values can be passed via `--values-json` (recommended) or as inline rows.145- Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).146- Confirm before sending mail or creating events.147- `gog gmail search` returns one row per thread; use `gog gmail messages search` when you need every individual email returned separately.