list_email_folders

macOS

Doel

Toont de volledige mappenstructuur (mailboxen) voor Apple Mail-accounts (Mail.app), inclusief geneste submappen. Gebruik dit om de exacte mapnamen te achterhalen die move_email(target_mailbox=...) en list_emails(mailbox=...) verwachten. Outlook.com-, Exchange-, Gmail-, iCloud- en IMAP-accounts die aan Mail.app zijn toegevoegd, worden allemaal meegenomen. Gebruik voor een Microsoft 365-mailbox die alleen via Graph werkt en niet aan Mail.app is toegevoegd in plaats daarvan m365_list_emails. Geef account=<name> mee (uit list_email_accounts) om één account volledig op te sommen; zonder dit wordt elk account doorlopen, wat op macOS 15+ traag kan zijn. Berichtaantallen staan standaard uit (traag bij IMAP) — geef include_counts=true mee om ongelezen/totaal per map toe te voegen (uit de lokale index van Mail wanneer een benoemd account vanaf schijf wordt opgelost, anders uit de eigen live telling van Mail.app — zie in beide gevallen unread_count_note in het antwoord).

Vereiste invoer

Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

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

Documentatievoorbeeld

Documentatievoorbeeld voor list_email_folders. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

{}