list_emails

macOS

Zweck

Verwenden Sie dies, wenn der Benutzer seinen Posteingang auf diesem Mac sehen oder sortieren möchte (Apple Mail – jedes zu Mail.app hinzugefügte Konto: iCloud, Gmail, IMAP, Exchange). Listet E-Mail-Header auf (Betreff, Absender, Datum, ungelesen); Rufen Sie read_email(message_id) für den gesamten Körper auf. Für ein zu Mail.app hinzugefügtes Microsoft 365-Postfach NOT verwenden Sie m365_list_emails. IMPORTANT: Auf Computern mit mehr als 2 Konten rufen Sie mit account=<name> (von list_email_accounts) auf. Ohne sie und wenn der schnelle Index nicht antworten kann, gibt list_emails die Kontoliste zurück, anstatt alle zu scannen – das Scannen jedes Kontos in einem Anruf ist zeitlich unbegrenzt und kann E-Mails auch für andere Anfragen blockieren (#2268). Genau 1 Konto ist nicht betroffen. Unterstützt Paginierung: Verwenden Sie Offset, um durch die Ergebnisse zu blättern (z. B. Offset=20 für Seite 2 mit Limit=20). Der Grenzwertparameter ist auf 50 pro Aufruf begrenzt (Standard: 20); Um mehr zu erfahren, blättern Sie mit Offset, anstatt ein höheres Limit anzufordern.

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

Dokumentationsbeispiel

Dokumentationsbeispiel für list_emails. 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.

{
  "limit": 5
}