gog-gmail

# Gmail <!-- Generated by scripts/gen-agent-skills.mjs; do not edit. --> Use `gog` for Gmail operations. Read `../gog/SKILL.md` first for shared auth, output, safety, and live-write rules. ## Safe start ```bash 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.