list_emails

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

Gebruik dit wanneer de gebruiker zijn of haar inbox op deze Mac wil bekijken of triëren (Apple Mail — elk account dat aan Mail.app is toegevoegd: iCloud, Gmail, IMAP, Exchange). Toont e-mailkoppen (onderwerp, afzender, datum, ongelezen); roep read_email(message_id) aan voor de volledige inhoud. Gebruik m365_list_emails voor een Microsoft 365-postbus die NIET aan Mail.app is toegevoegd. BELANGRIJK: roep op computers met 2+ accounts aan met account=<name> (uit list_email_accounts). Zonder dit retourneert list_emails, wanneer de snelle index geen antwoord kan geven, de accountlijst in plaats van alle accounts te doorzoeken — alle accounts in één aanroep scannen heeft geen tijdslimiet en kan Mail ook voor andere verzoeken blokkeren (#2268). Bij precies 1 account speelt dit niet. Ondersteunt paginering: gebruik offset om door resultaten te bladeren (bijvoorbeeld offset=20 voor pagina 2 met limit=20). De parameter limit is beperkt tot 50 per aanroep (standaard 20); gebruik offset voor volgende pagina's in plaats van een hogere limiet te vragen.

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"
    },
    "limit": {
      "default": "20",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "offset": {
      "default": "0",
      "minimum": 0,
      "type": "integer"
    },
    "unread_only": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor list_emails. 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.

{
  "limit": 5
}