gmail-clilisted

# Gmail (CLI) Use this plugin when Gmail access needs the raw Google Workspace CLI path, especially for binary attachments, unsupported MIME types, raw message payloads, label IDs, original MIME source, or exact API metadata that the curated Gmail connector cannot return. This is a product plugin backed by the installed `gws` CLI. Keep `gmail@openai-curated` available for normal mailbox search, thread summaries, drafts, sends, archive/delete actions, and user-friendly inbox triage. Use this CLI plugin as the precise fallback. ## Start ```bash command -v gws gws auth status gws gmail users getProfile --params '{"userId":"me"}' ``` If Gmail commands fail with `API not enabled`, the OAuth account can be valid while the Google Cloud project still lacks `gmail.googleapis.com`. Enable Gmail API for the project shown by `gws auth status`, wait briefly, then retry. ## Search And Inspect Prefer Gmail search syntax for message discovery: ```bash gws gmail users messages list --params '{"userId":"me","q":"from:bbva has:attachment newer_than:1y","maxResults":10}' gws gmail users messages get --params '{"userId":"me","id":"MESSAGE_ID","format":"metadata","metadataHeaders":["From","To","Subject","Date"]}' gws gmail users messages get --params '{"userId":"me","id":"MESSAGE_ID","format":"full"}' ``` Use `format=metadata` for first-pass reads and `format=full` only for shortlisted messages where payload parts, attachment IDs, or headers matter. Use bounded pagination when needed: `