list_email_folders

macOS

Zweck

Listet die vollständige Ordner-(Postfach-)Struktur für Apple Mail-Konten (Mail.app) auf, einschließlich verschachtelter Unterordner. Verwenden Sie dies, um die genauen Ordnernamen zu ermitteln, die move_email(target_mailbox=...) und list_emails(mailbox=...) erwarten. Zu Mail.app hinzugefügte Outlook.com-, Exchange-, Gmail-, iCloud- und IMAP-Konten sind alle enthalten. Für ein reines Graph-Microsoft 365-Postfach, das nicht zu Mail.app hinzugefügt wurde, verwenden Sie stattdessen m365_list_emails. Übergeben Sie account=<name> (aus list_email_accounts), um ein Konto vollständig aufzulisten. Ohne diese Angabe wird jedes Konto durchlaufen, was unter macOS 15+ langsam sein kann. Die Anzahl der Nachrichten ist standardmäßig deaktiviert (langsam bei IMAP) – übergeben Sie include_counts=true, um ungelesene Nachrichten/Gesamtanzahl pro Ordner hinzuzufügen (aus dem lokalen Index von Mail, wenn ein benanntes Konto von der Festplatte aufgelöst wird, sonst aus der eigenen Live-Zählung von Mail.app – siehe in beiden Fällen unread_count_note in der Antwort).

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für list_email_folders. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{}