list_email_folders
E-mail · macOS
Effect: lezen. Status: voorwaardelijk beschikbaar.
‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.
macOS
Doel
Toont de volledige mappenstructuur (postbussen) voor Apple Mail-accounts (Mail.app), inclusief geneste submappen. Gebruik dit om de exacte mapnamen te vinden 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 opgenomen. Gebruik voor een Microsoft 365-postbus die alleen via Graph beschikbaar is en niet aan Mail.app is toegevoegd in plaats daarvan m365_list_emails. Geef account=<name> (uit list_email_accounts) door om één account volledig te doorlopen; zonder dit worden alle accounts doorlopen, wat op macOS 15+ traag kan zijn. Berichten-aantallen zijn standaard uitgeschakeld (traag bij IMAP) — geef include_counts=true door om het aantal ongelezen/totaal per map toe te voegen.
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.
Canoniek technisch schema in het Engels — macOS
{
"properties": {
"account": {
"type": "string"
},
"include_counts": {
"default": "false",
"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.
{}