Thread management

Use thread tools to keep conversations coherent before sending follow-ups.

Open user guide

MCP thread tools

Use thread-aware tools to preserve reply context and avoid accidental context drift.

list_threads
List threads for your organization with optional read-state and label filters; use `limit` and `offset` for pagination.
get_thread
Load a full thread by ID, including messages and thread-level metadata.
search_threads
Search by keyword across subject, sender, and body to find the right conversation quickly.

MCP-first thread sequence

Use this order before replying to avoid fragmented conversations.

  1. 01Start with `list_threads` or `search_threads` for context on incoming work.
  2. 02Open the exact thread with `get_thread` before drafting follow-ups.
  3. 03Reply only through `reply_to_thread` to preserve references and keep headers aligned.
  4. 04If reply context is wrong, pause and inspect thread history again rather than sending a fresh email.

UI counterpart

Use inbox/thread views to catch human-review exceptions.

Thread timeline
Review full message chronology when machine context is ambiguous.
Search and labels
Use visual filters when you need quick triage across many active conversations.
Reply confirmation
Cross-check that subject, sender, and participants match expected thread context.