list_emails

Correo electrónico · macOS

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

Úselo cuando el usuario quiera ver o clasificar su bandeja de entrada en esta Mac (Apple Mail: cualquier cuenta agregada a Mail.app: iCloud, Gmail, IMAP, Exchange). Enumera los encabezados de correo electrónico (asunto, remitente, fecha, no leídos); llame a read_email (message_id) para el cuerpo completo. Para un buzón (`mailbox`) de correo de Microsoft 365 NO agregado a Mail.app, use m365_list_emails. IMPORTANTE: en máquinas con más de 2 cuentas, llame con account=<name> (desde list_email_accounts). Sin él, y cuando el índice rápido no puede responder, list_emails devuelve la lista de cuentas en lugar de escanearlas todas; escanear cada cuenta en una llamada no tiene límite (`limit`) de tiempo y también puede bloquear el correo para otras solicitudes (#2268). Exactamente 1 cuenta no se ve afectada. Admite paginación: utilice el desplazamiento (`offset`) para desplazar los resultados (por ejemplo, desplazamiento = 20 para la página 2 con límite = 20). El parámetro de límite tiene un límite de 50 por llamada (predeterminado 20); para leer más, página con desplazamiento en lugar de solicitar un límite mayor.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

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": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "offset": {
      "default": "0",
      "minimum": 0,
      "type": "integer"
    },
    "unread_only": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para list_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.

{
  "limit": 5
}