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-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore 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.