## §OIP SYSTEM ARTICLE — GMAIL (4 operations)
A generated article for one OIP shelf. It lists every operation in this API/CLI/MCP/device/model/core subsystem, links each leaf article, and gives the ledger path for proof.

### Read Order
- scan operations
- open a leaf doc
- run via run_now or POST /api/dispatch
- open receipt
- repair/replay if needed

### Operations
- **GMAIL_MESSAGES_SEARCH** — Search the connected Gmail with a Gmail query; returns message ids and thread ids (read-only grant).
  when: find mail before reading it with GMAIL_MESSAGE_GET.
  args: $1 = Gmail search, e.g. newer_than:7d from:stripe.com
  doc: https://miscsubjects.com/api/dispatch?key=GMAIL_MESSAGES_SEARCH&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GMAIL_MESSAGES_SEARCH&body=newer_than%3A7d&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GMAIL_MESSAGES_SEARCH
- **GMAIL_MESSAGE_GET** — One Gmail message's headers and snippet by id (read-only).
  when: after GMAIL_MESSAGES_SEARCH.
  args: $1 = message id
  doc: https://miscsubjects.com/api/dispatch?key=GMAIL_MESSAGE_GET&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GMAIL_MESSAGE_GET&body=18f%E2%80%A6&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GMAIL_MESSAGE_GET
- **GMAIL_MCP_SEARCH** — Search the owner Gmail (Google Workspace Gmail MCP) with a Gmail query; returns threads with ids for GMAIL_MCP
  when: find mail as the owner. Read-only.
  args: $1+ = Gmail search, e.g. from:stripe newer_than:7d
  doc: https://miscsubjects.com/api/dispatch?key=GMAIL_MCP_SEARCH&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GMAIL_MCP_SEARCH&body=newer_than%3A2d&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GMAIL_MCP_SEARCH
- **GMAIL_MCP_THREAD** — One Gmail thread in full (Gmail MCP).
  when: after GMAIL_MCP_SEARCH.
  args: $1 = thread id
  doc: https://miscsubjects.com/api/dispatch?key=GMAIL_MCP_THREAD&format=markdown
  run: https://miscsubjects.com/api/dispatch?invoke=GMAIL_MCP_THREAD&body=18f%E2%80%A6&share=<TOKEN>
  history: https://miscsubjects.com/api/invocations?object_id=GMAIL_MCP_THREAD

### Troubleshooting
- If a row's example has placeholders, replace only the placeholder values and preserve separators.
- If a call fails, open its receipt and repair it with POST /api/dispatch {key, body, repairs:'inv_ID'}.
- If token scope denies this system, ask the owner for a row:/rows:/pfx: token scoped to the exact operation set.

Back to the tree: https://miscsubjects.com/api/dispatch?map=1&format=markdown