List Proton Mail Emails
proton_list_emailsList emails in a folder, sorted newest first, with pagination support. Returns email summaries including subject, sender, and date.
Instructions
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 })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| folder | No | Mailbox folder path (e.g., 'INBOX', 'Sent', 'Folders/Partnerships') | INBOX |
| limit | No | Maximum emails to return (1–100, default 20) | |
| offset | No | Number of results to skip for pagination | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for structured data | markdown |