---
name: gog-gmail
description: "Gmail operations through gog."
---

# 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.