gmail-browser

name	gmail-browser
description	Configure Gmail Browser with /connect and use Gmail ConnectorAct actions through the global Puffer browser profile.
allowed-tools	["Bash"]
argument-hint	[Gmail Browser task]
arguments	target
user-invocable	true
disable-model-invocation	false

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 ConnectorAct for configured Gmail Browser connections instead of opening a separate browser session. 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":"[e-mail]","limit":20,"unread":true}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"search_emails","input":{"account":"[e-mail]","query":"from:alice newer:7d","limit":20}}
{"connector_slug":"gmail-browser","connection_slug":"gmail-browser","action":"draft_reply","input":{"account":"[e-mail]","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.