proton_send_email

Proton Mail · macOS · Windows

Effect: send (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

Sends a plain-text message from a connected Proton Mail address, through Proton Mail Bridge on this computer. The first call returns a preview with sender, recipients, subject and body, and connects to nothing; confirm=true sends. No attachments. It requires a Proton plan that includes Bridge, with Bridge running.

Required inputs

to — Recipient address, or several (an array, or separated by commas).
subject
body — Plain text.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the 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"
    },
    "body": {
      "description": "Plain text.",
      "type": "string"
    },
    "cc": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Copy recipients, the same form as `to`."
    },
    "confirm": {
      "description": "Must be true to send. Without it the call returns a preview and sends nothing.",
      "type": "boolean"
    },
    "subject": {
      "type": "string"
    },
    "to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Recipient address, or several (an array, or separated by commas)."
    }
  },
  "required": [
    "to",
    "subject",
    "body"
  ],
  "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.

{
  "body": "Can we review the launch checklist on Tuesday?",
  "confirm": false,
  "subject": "Planning meeting",
  "to": "sam@example.com"
}

Windows