list_calendar_events

macOS

Objectif

Répertorie les événements de l'application Calendrier du Mac (Calendar.app, calendriers locaux/iCloud) dans une plage de dates, ou lit l'événement ONE dans son intégralité via event_id. Liste des notes d'aperçu des entrées (200 caractères, indicateur notes_truncated) et plafond des participants ; passez event_id pour obtenir les notes complètes et la liste complète. La valeur par défaut est aujourd'hui + 7 jours. Pour un calendrier Microsoft 365, utilisez plutôt m365_list_events.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

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

Exemple documentaire

Exemple de documentation pour list_calendar_events. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "limit": 5
}