list_calendar_events
Kalender · macOS
Wirkung: Lesen. Status: bedingt verfügbar.
„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.
macOS
Zweck
Listet Ereignisse aus der Kalender-App des Mac (Calendar.app, lokale/iCloud-Kalender) in einem Datumsbereich auf oder liest das Ereignis ONE vollständig über event_id. Vorschaunotizen für Einträge auflisten (200 Zeichen, notes_truncated-Flag) und Teilnehmerzahl begrenzen; Geben Sie event_id ein, um die vollständigen Notizen und die vollständige Liste zu erhalten. Der Standardwert ist heute + 7 Tage. Verwenden Sie für einen Microsoft 365-Kalender stattdessen m365_list_events.
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.
Kanonisches technisches Schema auf Englisch — macOS
{
"properties": {
"calendar": {
"description": "Filter by calendar name — partial, case-insensitive (optional). To pick one of several same-titled calendars, qualify it as \"Account/Calendar\" (e.g. \"Exchange/Calendario\") using the source from list_calendar_names, or pass calendar_id.",
"type": "string"
},
"calendar_id": {
"description": "Filter by a single calendar UUID from list_calendar_names (optional).",
"type": "string"
},
"calendar_ids": {
"description": "Filter by multiple calendar UUIDs (optional).",
"items": {
"type": "string"
},
"type": "array"
},
"end_date": {
"description": "ISO 8601 date (YYYY-MM-DD). Defaults to start_date + 7 days.",
"type": "string"
},
"event_id": {
"description": "Read exactly ONE event by its id (from a previous list) with FULL notes and the complete attendee roster — required before editing notes of an event whose list entry says notes_truncated. When set, all other filters are ignored.",
"type": "string"
},
"limit": {
"description": "Max number of events to return (most recent first within the range). Optional; defaults to all in range.",
"type": "integer"
},
"start_date": {
"description": "ISO 8601 date (YYYY-MM-DD). Defaults to today.",
"type": "string"
}
},
"required": [],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für list_calendar_events. 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
}