proton_list_emails

Proton Mail · macOS · Windows

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Lists the newest messages of one folder of a Proton Mail account, newest first: id, sender, recipients, subject, date, size and flags. `folder` defaults to INBOX; Bridge names the others (Sent, Archive, All Mail, Folders/…, Labels/…). Paged with limit and offset. Nothing is marked as read. Read from Proton Mail Bridge on this computer; it requires a Proton plan that includes Bridge, with Bridge running.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "account": {
      "description": "The Proton Mail account: its address, as proton_connect lists it. Optional when one account is connected.",
      "type": "string"
    },
    "folder": {
      "description": "Folder name (default INBOX).",
      "type": "string"
    },
    "limit": {
      "description": "Messages per page (default 50, max 200).",
      "type": "integer"
    },
    "offset": {
      "description": "Messages to skip (default 0).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "account": "alex@example.com",
  "folder": "INBOX",
  "limit": 20
}

Windows