gog-gmail

Gmail

Use gog for Gmail operations. Read ../gog/SKILL.md first for shared auth, output, safety, and live-write rules.

Safe start

gog auth list --check --json --no-input
gog schema gmail --json
gog --readonly --account user@example.com gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted

• Select the account explicitly with --account.
• Use --json --wrap-untrusted for agent-readable Google content.
• Use --readonly when the task must not mutate Google data.
• Use --no-input in automation and --dry-run before supported writes.
• Confirm the exact account, object, and mutation before any write or delete.

Commands

Command	Purpose
archive	Archive messages or explicit threads (remove from inbox)
attachment	Download a single attachment
autoreply	Reply once to matching messages
batch	Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing)
drafts	Draft operations
forward	Forward a message to new recipients
get	Get a message (full|metadata|raw)
history	Gmail history
import	Import an RFC822/EML message into Gmail
labels	Label operations
mark-read	Mark messages as read
messages	Message operations
raw	Dump raw Gmail API response as JSON (Users.Messages.Get; lossless; for scripting and LLM consumption)
reply	Reply to a message
reply-all	Reply to all message participants
search	Search threads using Gmail query syntax
send	Send an email
settings	Settings and admin
thread	Thread operations (get, modify)
track	Email open tracking
trash	Move messages to trash
unread	Mark messages as unread
url	Print Gmail web URLs for threads

Run gog gmail <command> --help for flags and gog schema gmail <command> --json for the machine-readable contract. Do not guess command syntax.