create_email_folder

macOS

Propósito

Crea una carpeta de buzón en Apple Mail (Mail.app) del Mac, en una cuenta. Si Mail tiene más de una cuenta, `account` es obligatorio: la herramienta se niega a adivinar dónde va la carpeta (list_email_accounts da los nombres). Si ya existe una carpeta con ese nombre, no crea nada y lo dice. Informa created solo después de ver la carpeta en la lista de carpetas de la cuenta; en una cuenta de Exchange, donde Mail no puede confirmar la carpeta con el servidor, responde created=false con el estado server_unconfirmed: usa m365_create_email_folder para ese buzón. Si se llama sin confirm, devuelve una vista previa; pasa confirm=true para crearla.

Entradas obligatorias

• name

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 declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

• 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.

{
  "properties": {
    "account": {
      "description": "Account name (optional, uses default)",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "name": {
      "description": "Folder name",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}

Ejemplo documental

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

{
  "confirm": false,
  "name": "Planning meeting"
}