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> (von list_email_accounts), um ein Konto vollständig aufzulisten. Ohne sie wird jedes Konto gelöscht, 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.

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

{}