Previous value: -"Folders to search, each an alias, a folder or label name, or a folder id (names and aliases resolve for you). IMAP covers INBOX only unless you name archive or sent folders; Gmail and Outlook search every folder except the trash (Deleted Items on Outlook; Gmail also skips Spam), so name it to include it."New value: +"Folders to search, each a folder or label name or id from folder_list, or an alias (works where the mailbox has that role). IMAP covers INBOX only unless you name archive or sent folders; Gmail and Outlook search every folder except the trash (Deleted Items on Outlook; Gmail also skips Spam), so name it to include it."

Previous value: -"Folders to search, each an alias, a folder or label name, or a folder id (names and aliases resolve for you). IMAP covers INBOX only unless you name archive or sent folders; Gmail and Outlook always search everything."New value: +"Folders to search, each an alias, a folder or label name, or a folder id (names and aliases resolve for you). IMAP covers INBOX only unless you name archive or sent folders; Gmail and Outlook search every folder except the trash (Deleted Items on Outlook; Gmail also skips Spam), so name it to include it."

Previous value: -"true = only flagged/starred messages. Ignored on Outlook."New value: +"true = only flagged/starred messages."

Previous value: -"Received strictly before this date or datetime (no timezone = UTC)."New value: +"Received strictly before this date or datetime (no timezone = UTC). Takes the same relative forms as `since`."

Previous value: -"Inbox UUID from inbox_list. Optional when the key has one inbox; pass this or `inbox`, not both."New value: +"Inbox UUID from inbox_list. Optional when the key has one inbox; pass this or `inbox`, not both — a pair naming different mailboxes is refused."

Previous value: -"Received on or after this date or datetime (no timezone = UTC)."New value: +"Received on or after this date or datetime (no timezone = UTC). Also takes \"2026-06\", \"today\", \"7 days ago\", \"last month\" or \"30d\"."

Previous value: -"Text to match in the subject; phrases match as-is."New value: +"Text to match in the subject, as written. Gmail (API or IMAP) and Outlook match WHOLE WORDS, so a partial word finds nothing; other IMAP servers substring-match."

Previous value: -"Folder names to search."New value: +"Folders to search, each an alias, a folder or label name, or a folder id (names and aliases resolve for you). IMAP covers INBOX only unless you name archive or sent folders; Gmail and Outlook always search everything."

Previous value: -"Which operation to perform. Determines which other arguments are used."New value: +"Operation to run. delete = one message_id; delete_batch = up to 500 message_ids; search_and_delete = every message matching a search, up to limit; the result's has_more says whether matches were left behind."

Previous value: -"ISO 8601 date or datetime; return messages received strictly before (<) this instant."New value: +"Received strictly before this date or datetime (no timezone = UTC)."

Previous value: -"date-time"New value: +"date-or-date-time"

Previous value: -"Free text to find in the message body. (On Gmail this matches the whole message, not body-only.)"New value: +"Text to find in the body. On Gmail this matches the whole message."

Previous value: -"Carbon-copy (Cc) recipient to match: email address, display name, or fragment."New value: +"Cc recipient to match: address, name, or fragment."

Previous value: -"true = only flagged/starred messages. Not supported on Outlook/Graph (ignored there)."New value: +"true = only flagged/starred messages. Ignored on Outlook."

Previous value: -"Sender to match: email address, display name, or fragment (e.g. \"alice@example.com\" or \"Alice\")."New value: +"Sender to match: address, name, or fragment."

Previous value: -"true = only messages with an attachment. Not supported on generic IMAP (ignored there)."New value: +"true = only messages with an attachment. Ignored on generic IMAP."

Added value: +{
+  "description": "Reuse only when retrying the identical request within 24 hours; the retry is collapsed, not repeated. Reuse with different arguments is rejected.",
+  "maxLength": 200,
+  "minLength": 1,
+  "type": "string"
+}

Previous value: -"Email address of the inbox to use, as a friendly alternative to inbox_id. Optional; ignored if inbox_id is given."New value: +"Inbox email address, an alternative to inbox_id."

Previous value: -"UUID of the inbox to use. Optional when the API key has access to exactly one inbox (it is auto-selected). Alternatively pass `inbox` with an email address. If you don't know the inbox_id and several are accessible, just omit it — the response then lists every inbox with its inbox_id so you can retry (calling inbox_list does the same)."New value: +"Inbox UUID from inbox_list. Optional when the key has one inbox; pass this or `inbox`, not both."

Previous value: -"Optional list of folder/mailbox names to restrict the search scope."New value: +"Folder names to search."

Previous value: -"Maximum number of matching messages to delete. Default: 500."New value: +"Cap on messages deleted. Default 500."

Previous value: -"Provider-native message ID as returned by email_list, email_read, or email_search."New value: +"Provider-native message id from a list or search."

Previous value: -"Provider-native message IDs to delete. Maximum 500 IDs per call."New value: +"Provider-native message ids to delete. Duplicates are removed, first occurrence kept, so succeeded counts distinct messages."

Previous value: -"When true, hard-deletes the message (bypasses Trash). When false or omitted, moves the message to Trash. Default: false."New value: +"Hard-delete, bypassing Trash. Default false, which trashes it."

Previous value: -"Raw provider-native query string (escape hatch). Prefer the structured fields above. Combined with them where supported; ignored on Fastmail."New value: +"Provider-native raw query (escape hatch); prefer the structured fields. Ignored on Fastmail."

Previous value: -"ISO 8601 date or datetime; return messages received on/after (>=) this instant. E.g. \"2026-06-01\"."New value: +"Received on or after this date or datetime (no timezone = UTC)."

Previous value: -"date-time"New value: +"date-or-date-time"

Previous value: -"Text to match in the subject line. Multi-word phrases are matched as-is."New value: +"Text to match in the subject; phrases match as-is."

Previous value: -"Free text to match anywhere in the message (headers and body)."New value: +"Text to match anywhere, headers included."

Previous value: -"Primary (To) recipient to match: email address, display name, or fragment."New value: +"To recipient to match: address, name, or fragment."

Previous value: -"true = only unread messages; false = only read messages; omit for either."New value: +"true = unread only; false = read only; omit for both."

Previous value: -nullNew value: +{
+  "additionalProperties": true,
+  "properties": {
+    "failed": {
+      "type": "integer"
+    },
+    "has_more": {
+      "description": "True when messages matching the query were left UNTOUCHED because of the limit. Check this before reporting the sweep complete: re-run until it is false.",
+      "type": "boolean"
+    },
+    "inbox_id": {
+      "type": "string"
+    },
+    "notes": {
+      "description": "Server notes about how this call was handled — for example an argument that was not applied because the selected action does not accept it. Written by MCP Emails, not taken from any message, and absent when there is nothing to report.",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "operation": {
+      "type": "string"
+    },
+    "succeeded": {
+      "type": "integer"
+    }
+  },
+  "type": "object"
+}