Gmail Browser

Use /connect gmail-browser <connection> when the user needs Gmail Browser setup or auth repair. The flow opens Gmail in the global Puffer browser profile, lets the user sign in, discovers logged-in Gmail accounts, and saves the accounts selected for monitoring.

Target: $target

Configuration command:

/connect gmail-browser <connection>

Use connector tools for configured Gmail Browser connections instead of opening a separate browser session. Use ConnectorActionDraft for send_email so the human can review the exact outbound email before sending; use ConnectorAct for reads, drafts, and other non-send actions. Gmail Browser uses email-style action names:

• list_emails for recent messages with optional mailbox, category, label, query, from, subject, keywords, unread, and limit.
• list_inbox, list_category, and search_emails as read/search variants.
• mark_read, draft_reply, draft_forward, send_email, and delete for message state changes, drafts, sends, and deletion.
• requestuserbrowseraction only when the connector needs the user to complete sign-in or approval in the global Puffer browser profile.

Do not use read_messages for Gmail Browser. That action name belongs to chat connectors such as Slack and Lark. For Gmail Browser reads, use list_emails or search_emails.

Connector action examples:

{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"list_emails","input":{"account":"cs@agentenv.io","limit":20,"unread":true}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"search_emails","input":{"account":"cs@agentenv.io","query":"from:alice newer:7d","limit":20}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"draft_reply","input":{"account":"cs@agentenv.io","thread_id":"thread-a:r123","body":"Thanks, looking now."}}

When a connection monitors multiple accounts, include account with the Gmail address to select the mailbox. If omitted, Gmail Browser uses the first configured account for that connection.