Fetch one attachment's content into the conversation (up to 25 MB decoded). Images are returned as image content; other files as base64 in the structured output alongside the metadata. For an attachment too large to be worth reading inline, use save_attachment instead.

Read one message: envelope metadata, decoded plain-text and HTML bodies, and attachment list, all as structured output.

Read a whole conversation from one of its messages, oldest first. Returns each message's envelope and message_id, and with include_bodies a shortened body for each. A conversation is usually split across folders, with your own replies in Sent, so pass the All Mail folder as search_folder to gather all of it. Use the returned uid and uidvalidity with get_email for a message in full.

List a message's attachments (filename, content type, encoded size) without transferring any content.

List messages in a folder, newest first, with pagination. Returns envelope summaries (subject, sender, date, flags) and the folder's uidvalidity.

List all folders (mailboxes) in the Proton Mail account, including system folders like INBOX, Sent, and Archive.

Write one attachment (up to 25 MB decoded) to a local file on the server's machine and return only its path, keeping the bytes out of the conversation. Use this for attachments too large to read inline with get_attachment. An existing file is never overwritten and no directories are created.

Create a complete Proton Mail draft, or replace an existing draft when uid and uidvalidity are provided. Supports plain text, an optional HTML alternative, and bounded attachments supplied either inline as base64 (content_base64) or as an absolute path to a local file that the server reads at save time (content_path). To reply inside a thread, read the message with get_email and set in_reply_to to its message_id, and references to its references followed by its message_id; when it reports no references, use its in_reply_to in their place so earlier ancestry survives. A replacement keeps the previous draft's Message-ID, plus whichever of its In-Reply-To and References the call omits; passing an empty array for either removes it, detaching the draft from its thread. Updating appends the replacement before removing the old UID; inspect warning if cleanup was incomplete.

Search messages in a folder by text, sender, recipient, subject, date range, or unread state. Returns envelope summaries newest first, with pagination.