App Logo
mail.google.com

Toggle Gmail thread read state

Automatically toggle Gmail thread read state on mail.google.com. Mark a Gmail thread as read or unread by its hex threadId, in the chosen Google account. Pass read:true to mark as read (default), read:false to mark as unread. Returns the final read and unread state, threadId, and already_read/already_unread when the thread was already in the requested state and was left alone, so repeating the call is safe. Success is reported only once Gmail has saved the change and a fresh read confirms it. An unknown or malformed id is refused without changing anything.

Input

threadId required

Hex legacy thread id (as returned by search_emails).

read optional

true to mark as read (default), false to mark as unread.

Default: true
account optional

The Google account whose thread this is: its email address, or Gmail's account number in this browser (e.g. "2"). The run fails if that account is not signed in. Omit for the first signed-in account (u/0).

Output

read required

The final read state: true if thread is now read.

unread required

The final unread state: true if thread is now unread.

threadId required
already_read optional

true = the thread was already read; nothing was clicked.

already_unread optional

true = the thread was already unread; nothing was clicked.

FAQ

Mark a Gmail thread as read or unread by its hex threadId, in the chosen Google account. Pass read:true to mark as read (default), read:false to mark as unread. Returns the final read and unread state, threadId, and already_read/already_unread when the thread was already in the requested state and was left alone, so repeating the call is safe. Success is reported only once Gmail has saved the change and a fresh read confirms it. An unknown or malformed id is refused without changing anything.
Ask an AI agent connected to Reduck to run reduck/mail.google.com/toggle_read_state, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/mail.google.com/toggle_read_state
You do not need one. "Toggle Gmail thread read state" drives the real mail.google.com pages in a browser, so it works whether or not mail.google.com offers an API for this.
Required: threadId. Optional: read, account.
It returns read, unread, threadId, already_read, already_unread.
Yes. It acts as you on mail.google.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the mail.google.com cookies saved by the Reduck extension.
It makes changes on mail.google.com, like sending, posting, booking or buying something.
Ask an AI agent connected to Reduck to run reduck/mail.google.com/toggle_read_state, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/mail.google.com/toggle_read_state
It is part of Reduck's official curated catalogue.

Related scripts

mail.google.com

Search Gmail

Search the signed-in Gmail with the native query syntax (from:, to:, subject:, has:attachment, after:/before:, labels…) and return matching threads: threadId (feed it to get_thread / reply_to_email), sender, senderEmail, subject, snippet, date, unread, starred, hasAttachment. Results are threads rather than individual messages, which is Gmail's own search granularity, and only the first page of results is returned (up to 50).

mail.google.com

Send Gmail email

Send an email from the signed-in Gmail account, with a plain-text body and an optional single file attachment. Always starts a new conversation. To answer inside an existing thread, use mail.google.com/reply_to_email.

mail.google.com

Get Gmail thread

Read a Gmail thread by its hex threadId (as returned by search_emails): subject plus every rendered message's from, fromEmail, to, date, plain-text body and attachment names. In long threads Gmail collapses older messages, so only rendered (expanded) messages are returned.

Start building not clicking

Get started for free