gog-extended

Complete reference for the gog CLI with focus on advanced Gmail operations (full email bodies, attachments, complex searches).

Setup (one-time)

CODEBLOCK0

Gmail Operations

Search & Browse

• - Search threads (one row per thread):

• - Search individual messages (ignores threading, returns all matches):

Read Full Email Content (Critical for Automation)

This is the key difference from basic search — retrieve the complete email body, headers, and content:

CODEBLOCK3

Recommendation: Use --format=full (default) which returns HTML-formatted email bodies. HTML preserves structure, links, and formatting better than raw RFC 2822, making it easier to parse and extract data programmatically.

Example workflow (extracting order details from email):
CODEBLOCK4

The HTML format makes it easier to identify structure (tables, divs, links) and extract data without dealing with raw MIME encoding.

Download Attachments

CODEBLOCK5

Get attachment IDs from gog gmail get <messageId> --format=full output.

Send Emails

• - Plain text:

• - Multi-line (via file):

• - Multi-line (via stdin):

• - HTML:

Drafts

CODEBLOCK10

Reply to Messages

CODEBLOCK11

Gmail History (Last Changes)

CODEBLOCK12

Gmail URL Links

CODEBLOCK13

Prints direct Gmail web URLs.

Calendar Operations

List Events

CODEBLOCK14

Create Event

CODEBLOCK15

With color (IDs 1–11):

CODEBLOCK16

Update Event

CODEBLOCK17

View Color Palette

CODEBLOCK18

Color IDs:

• - 1: #a4bdfc (blue)
• 2: #7ae7bf (teal)
• 3: #dbadff (purple)
• 4: #ff887c (red)
• 5: #fbd75b (yellow)
• 6: #ffb878 (orange)
• 7: #46d6db (cyan)
• 8: #e1e1e1 (gray)
• 9: #5484ed (dark blue)
• 10: #51b749 (green)
• 11: #dc2127 (dark red)

Drive Operations

CODEBLOCK19

Contacts

CODEBLOCK20

Sheets

Read Data

CODEBLOCK21

Update Data

CODEBLOCK22

Append Data

CODEBLOCK23

Clear Data

CODEBLOCK24

Docs

Export

CODEBLOCK25

Read (cat)

CODEBLOCK26

Advanced Flags

Common Flags

• - --account you@gmail.com — Target specific account (required when multiple accounts configured)
• INLINECODE4 — Output JSON (best for scripting)
• INLINECODE5 — Stable TSV format (no colors)
• INLINECODE6 — Preview changes without executing
• INLINECODE7 — Skip confirmations
• INLINECODE8 — Never prompt (useful for CI/automation)
• INLINECODE9 — Enable verbose logging

Environment Variable

Avoid repeating --account by setting:

CODEBLOCK27

Then:

CODEBLOCK28

Gmail Query Syntax

Powerful search operators for gog gmail search and gog gmail messages search:

• - newer_than:7d — Last 7 days
• INLINECODE14 — Before date
• INLINECODE15 — After date
• INLINECODE16 — From specific sender
• INLINECODE17 — To specific recipient
• INLINECODE18 — Subject contains
• INLINECODE19 — In inbox (also: sent, draft, starred, important)
• INLINECODE24 — Unread messages
• INLINECODE25 — Has attachment
• INLINECODE26 — Attachment name
• INLINECODE27 — Custom labels

Complex queries:

CODEBLOCK29

Notes

• - Search vs Messages: gog gmail search returns one row per thread; use gog gmail messages search when you need every individual email.
• Multi-account: When multiple accounts are configured, always specify --account email@domain.com.
• Token efficiency: For scripting, use --json output and parse programmatically.
• Email body extraction: Use gog gmail get <messageId> --format=full to retrieve complete email content (critical for automation like order tracking, invoice extraction, etc.).
• Docs are read-only in gog: In-place edits require a separate Docs API client; gog supports export and read-only operations.