proton_search_emails

Proton Mail · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Busca en una carpeta de una cuenta de Proton Mail el texto `query` en los encabezados y el texto de los mensajes, del más nuevo al más antiguo. `folder` es INBOX por defecto; "All Mail" busca en todos los mensajes. `since` y `until` la acotan a un período de días. La búsqueda la ejecuta Proton Mail Bridge en este equipo. Nada se marca como leído. Se lee desde Proton Mail Bridge en este equipo; requiere un plan de Proton que incluya Bridge, con Bridge en ejecución.

Entradas obligatorias

query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Matches to skip (default 0).",
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    },
    "since": {
      "description": "Only messages received on or after this day (2026-01-31).",
      "type": "string"
    },
    "until": {
      "description": "Only messages received on or before this day.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para proton_search_emails. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "folder": "All Mail",
  "limit": 20,
  "query": "launch checklist",
  "since": "2026-10-01"
}

Windows