list_email_folders

E-mail · macOS

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Liste l'arborescence complète des dossiers (boîtes aux lettres) des comptes Apple Mail (Mail.app), sous-dossiers imbriqués compris. Utilisez-la pour découvrir les noms de dossier exacts qu'attendent move_email(target_mailbox=...) et list_emails(mailbox=...). Les comptes Outlook.com, Exchange, Gmail, iCloud et IMAP ajoutés à Mail.app sont tous inclus. Pour une boîte Microsoft 365 accessible uniquement via Graph et non ajoutée à Mail.app, utilisez plutôt m365_list_emails. Passez account=<name> (issu de list_email_accounts) pour énumérer un compte en entier ; sans cela, tous les comptes sont parcourus, ce qui peut être lent sous macOS 15+. Les nombres de messages sont désactivés par défaut (lent sur IMAP) ; passez include_counts=true pour ajouter non lus/total par dossier (depuis l'index local de Mail lorsqu'un compte nommé se résout depuis le disque, ou depuis le décompte en direct de Mail.app sinon ; dans les deux cas, voir unread_count_note dans la réponse).

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "account": {
      "description": "Mail.app account whose folder tree to list (from list_email_accounts). Defaults to every account.",
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "description": "Include the message count of each folder. Slower, because each folder has to be counted.",
      "type": "boolean"
    }
  },
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour list_email_folders. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{}