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,docs,sheets
• gog auth list

Common commands

• 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 read email body: gog gmail get --account you@example.com
• Get message ID from search, then use get to fetch full body
• Use --format metadata for just headers, --format raw for raw RFC822
• Gmail attachments: gog gmail attachment --out /path/to/save
• 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 "

  Hello

  "
• Gmail draft: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
• Gmail send draft: gog gmail drafts send
• Gmail reply: gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id
• Calendar list events: gog calendar events --from --to
• Calendar create event: gog calendar create --summary "Title" --from --to
• Calendar create with color: gog calendar create --summary "Title" --from --to --event-color 7
• Calendar update event: gog calendar update --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 "Tab!A1:D10" --json
• Sheets update: gog sheets update "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
• Sheets append: gog sheets append "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
• Sheets clear: gog sheets clear "Tab!A2:Z"
• Sheets metadata: gog sheets metadata --json
• Docs export: gog docs export --format txt --out /tmp/doc.txt
• Docs cat: gog docs cat

Calendar Colors

• Use gog calendar colors to see all available event colors (IDs 1-11)
• Add colors to events with --event-color 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:

  for paragraphs,
for line breaks, for bold, for italic, for links,

  /
  • for lists.
  • Example (plain text via stdin):

  ```bash

  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):

  ```bash

  gog gmail send --to recipient@example.com \

  --subject "Meeting Follow-up" \

  --body-html "

  Hi Name,

  Thanks for meeting today. Here are the next steps:

  • Item one
  • Item two

  Best regards,
  Your Name

  "

  ```

  Notes

  Headless/EC2 setup: On headless machines (no TTY), gog needs GOG_KEYRING_PASSWORD set:

  • Add to shell profile: export GOG_KEYRING_PASSWORD=your-password
  • Add to systemd service: Environment=GOG_KEYRING_PASSWORD=your-password
  • Or use file keyring: gog auth keyring file
  • 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.
  • gog gmail search returns one row per thread; use gog gmail messages search when you need every individual email returned separately.