List all mailbox folders in the Proton Mail account with message counts and unread counts.

Use this tool to discover available folders before listing or searching emails.

Args:

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: A list of folders with path, message count, and unread count.

Examples:

• "What folders do I have?" -> proton_list_folders()

• "How many unread emails do I have?" -> proton_list_folders()

List emails in a folder, sorted newest first, with pagination support.

Returns email summaries (subject, from, date, snippet) — not full bodies. Use proton_get_email to read an individual email's full content.

Args:

• folder (string): Mailbox folder path (default: 'INBOX')

• limit (number): Maximum emails to return, 1–100 (default: 20)

• offset (number): Skip this many emails for pagination (default: 0)

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: Paginated list of email summaries with total count and pagination metadata.

Examples:

• "Show my latest emails" -> proton_list_emails({ folder: "INBOX" })

• "What's in my Sent folder?" -> proton_list_emails({ folder: "Sent" })

• "Show me the next page" -> proton_list_emails({ folder: "INBOX", offset: 20 })

Retrieve a single email's full content by its IMAP UID, including body text and attachment metadata.

Use proton_list_emails or proton_search_emails first to find the UID of the email you want to read.

Args:

• folder (string): The folder containing the email (default: 'INBOX')

• uid (number): The IMAP UID of the email

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: Full email with headers, body text, and attachment list. Does NOT return attachment binary data.

Examples:

• "Read email 1234" -> proton_get_email({ folder: "INBOX", uid: 1234 })

• "Show me that email from Alice" -> first search, then get by UID

Search emails in a folder using IMAP search criteria. Supports filtering by sender, recipient, subject, body text, date range, and read/flagged status.

Returns email summaries — use proton_get_email to read the full content of a specific result.

Args:

• folder (string): Folder to search in (default: 'INBOX')

• from (string, optional): Filter by sender email or name

• to (string, optional): Filter by recipient email or name

• subject (string, optional): Filter by subject text

• body (string, optional): Search within email body

• since (string, optional): Emails after this date (ISO 8601, e.g., '2025-01-01')

• before (string, optional): Emails before this date (ISO 8601)

• unseen (boolean, optional): Only unread emails

• flagged (boolean, optional): Only starred/flagged emails

• limit (number): Max results, 1–100 (default: 20)

• offset (number): Pagination offset (default: 0)

• response_format ('markdown' | 'json'): Output format (default: 'markdown')

Returns: Paginated list of matching email summaries.

Examples:

• "Find emails from Alice" -> proton_search_emails({ from: "Alice" })

• "Unread emails about quarterly report" -> proton_search_emails({ subject: "quarterly report", unseen: true })

• "Emails from acme.com in March" -> proton_search_emails({ from: "acme.com", since: "2025-03-01", before: "2025-04-01" })