list_email_folders

macOS

Objectif

Répertorie l'arborescence complète des dossiers (boîtes aux lettres) pour les comptes Apple Mail (Mail.app), y compris les sous-dossiers imbriqués. Utilisez-le pour découvrir les noms de dossier exacts attendus par 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 aux lettres Microsoft 365 uniquement graphique non ajoutée à Mail.app, utilisez plutôt m365_list_emails. Passez account=<name> (depuis list_email_accounts) pour énumérer entièrement un compte ; sans cela, chaque compte est parcouru, ce qui peut être lent sur macOS 15+. Le nombre de messages est désactivé par défaut (lent sur IMAP) — transmettez include_counts=true pour ajouter les non lus/total par dossier.

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.

{
  "properties": {
    "account": {
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "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.

{}