update_email_status
Mark emails as read/unread or flag/unflag using filters like subject, sender, age, or exact message IDs. Choose an account and action, then filter or target specific emails for status updates.
Instructions
Update email status - mark as read/unread or flag/unflag emails.
When message_ids is provided, uses exact ID matching (ignores other filters). Otherwise filters by subject, sender, and/or age.
Args: account: Account name (e.g., "Gmail", "Work") action: Action to perform: "mark_read", "mark_unread", "flag", "unflag" subject_keyword: Optional keyword to filter emails by subject subject_keywords: Optional list of subject keywords; matches any keyword sender: Optional sender to filter emails by mailbox: Mailbox to search in (default: "INBOX") max_updates: Maximum number of emails to update (safety limit, default: 10) apply_to_all: Must be True to allow updates without any filter message_ids: Optional list of exact Mail message ids for precise targeting older_than_days: Optional age filter - only update emails older than N days
Returns: Confirmation message with details of updated emails
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | Yes | ||
| action | Yes | ||
| subject_keyword | No | ||
| subject_keywords | No | ||
| sender | No | ||
| mailbox | No | INBOX | |
| max_updates | No | ||
| apply_to_all | No | ||
| message_ids | No | ||
| older_than_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |