List every folder and label of the mailbox. Use this first when you do not know where a message lives; the returned names are valid values for other tools.

List the most recent messages of a folder, newest first.

Args: folder: Folder or label name, as returned by list_folders. limit: Maximum number of messages to return (1-100). unread_only: Only return unread messages when true. since_days: Only return messages from the last N days when set. sender: Only return messages whose From header contains this text. subject: Only return messages whose Subject header contains this text. before: Cursor from a previous page's next_cursor to continue listing.

Search messages, newest first. All filters combine with AND.

Args: query: Full-text across headers and body; empty matches everything. folder: Folder or label name to search in, as returned by list_folders. limit: Maximum number of messages to return (1-100). sender: Substring match on the From header. recipient: Substring match on the To header. subject: Substring match on the Subject header. since_days: Only messages received in the last N days. before_days: Only messages received before N days ago. unread_only: Only unread messages when true. has_attachment: Only messages carrying an attachment. IMAP cannot search on this, so up to 200 newest candidates are checked with BODYSTRUCTURE; the result reports how many were scanned and whether the set was truncated.

Read one full message, identified by the Message-ID returned by list_emails or search_emails. Returns headers, decoded text body, attachment names, and flags.

Args: message_id: Full Message-ID header value, including angle brackets. folder: Folder the message is in. max_chars: Maximum body characters to return; longer bodies are truncated.

Counts of total and unread messages per folder, without fetching messages.

Args: folder: A single folder name, or omit to get every selectable folder.

Compact digest of a folder: unread count plus recent message summaries (subjects and senders only, no bodies).

Args: folder: Folder to summarize. days: Window in days (default 1). limit: Maximum messages in the digest (1-100).

Reconstruct a conversation around a message using References/In-Reply-To, searching All Mail. Returns messages in chronological order.

Args: message_id: Message-ID of any message in the thread. folder: Folder containing that message (used as a fallback if All Mail is absent). limit: Maximum messages in the thread (1-100).

List a message's attachments (names, content types, sizes) without saving anything to disk.

Args: message_id: Message-ID of the message. folder: Folder containing the message.

Save one attachment into the local sandbox directory. Files are never overwritten and never leave the sandbox.

Args: message_id: Message-ID of the message. folder: Folder containing the message. filename: Exact attachment filename; omit when the message has exactly one. index: Attachment position (0-based) when filenames are ambiguous.

Export a full message as .eml into the local sandbox directory.

Args: message_id: Message-ID of the message. folder: Folder containing the message. filename: Optional target filename; defaults to the Message-ID plus .eml.