list_email_folders

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

Muestra el árbol completo de carpetas (buzón) para las cuentas de Apple Mail (Mail.app), incluidas las subcarpetas anidadas. Utilice esto para descubrir los nombres de carpeta exactos que esperan move_email (target_mailbox =...) y list_emails (buzón=...). Se incluyen las cuentas Outlook.com, Exchange, Gmail, iCloud y IMAP agregadas a Mail.app. Para un buzón de Microsoft 365 solo de Graph que no se agrega a Mail.app, use m365_list_emails en su lugar. Pase account=<name> (de list_email_accounts) para enumerar una cuenta por completo; sin él, todas las cuentas se bloquean, lo que puede resultar lento en macOS 15+. El recuento de mensajes está desactivado de forma predeterminada (lento en IMAP); pase include_counts=true para agregar no leídos/total por carpeta.

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"
    },
    "include_counts": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Ejemplo documental

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

{}