Rechercher dans le calendrier

Nom de l'outilsearch_calendar_events
Lecture seuleIdempotent

Description

Texte exact envoyé au modèle par tools/list :

Liste ou recherche les événements du calendrier Oxygenius (rendez-vous, bureau, congés…) sur une période, par ordre chronologique, avec les personnes concernées. Les événements privés des autres utilisateurs apparaissent comme « Privé », sans contenu. Par défaut : les 30 prochains jours à partir d'aujourd'hui ; avec une seule date, 30 jours à partir d'elle (ou jusqu'à elle). Période maximale : 366 jours. Les heures sont en heure locale belge. Utiliser get_calendar_event pour le détail.

Accès requis

Paramètres

NomTypePrésenceDescription
querystringfacultatifMots-clés : objet, description, lieu, référence ou intitulé du dossier, nom du client.
fromstring (date)facultatifPremier jour de la période (AAAA-MM-JJ).
tostring (date)facultatifDernier jour de la période (AAAA-MM-JJ), inclus.
dossierIdintegerfacultatifIdentifiant d'un dossier pour n'avoir que ses événements.
assigneestringfacultatifNom ou prénom d'une personne concernée.
typestringfacultatifFragment du libellé du type d'événement (ex. rendez-vous, congé).
limitintegerfacultatifNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Par défaut : 10
offsetintegerfacultatifNombre de résultats à sauter pour la pagination (0 par défaut).
Par défaut : 0

Résultat

Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.

Champs du résultat
NomTypePrésenceDescription
totalCountintegerNombre total d'éléments correspondant aux critères.
offsetintegerPosition du premier élément de la page.
limitintegerTaille de page appliquée (le serveur plafonne la valeur demandée).
hasMorebooleanVrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.
itemsobject[]Éléments de la page.
items[].idintegerIdentifiant de l'événement (à passer à get_planning_event ou get_calendar_event).
items[].kindstringplanning ou calendar : écran d'origine de l'événement.
items[].subjectstringpeut être nullObjet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.
items[].startstring (date-time)Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).
items[].endstring (date-time)Fin, en heure locale belge avec son décalage UTC.
items[].typestringpeut être nullType d'événement (chantier, rendez-vous, congé, intervention…).
items[].siteStatestringpeut être nullÉtat de chantier (planifié, validé…), pour le planning.
items[].locationstringpeut être nullLieu saisi sur l'événement (masqué pour un événement privé d'autrui).
items[].isPrivatebooleanVrai pour un événement privé.
items[].dossierIdintegerpeut être nullIdentifiant du dossier lié (à passer à get_dossier).
items[].dossierReferencestringpeut être nullRéférence du dossier lié.
items[].dossierIndicationstringpeut être nullIntitulé court du dossier lié.
items[].assigneesstring[]Personnes affectées à cette occurrence.

Annotations MCP

AnnotationValeurSignification
titleRechercher dans le calendrierNom lisible affiché par le client MCP.
readOnlyHintouiL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintnonL'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur.

Définition JSON

Entrée exacte de tools/list
{
  "name": "search_calendar_events",
  "title": "Rechercher dans le calendrier",
  "description": "Liste ou recherche les événements du calendrier Oxygenius (rendez-vous, bureau, congés…) sur une période, par ordre chronologique, avec les personnes concernées. Les événements privés des autres utilisateurs apparaissent comme « Privé », sans contenu. Par défaut : les 30 prochains jours à partir d'aujourd'hui ; avec une seule date, 30 jours à partir d'elle (ou jusqu'à elle). Période maximale : 366 jours. Les heures sont en heure locale belge. Utiliser get_calendar_event pour le détail.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "Mots-clés : objet, description, lieu, référence ou intitulé du dossier, nom du client.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "from": {
        "description": "Premier jour de la période (AAAA-MM-JJ).",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "to": {
        "description": "Dernier jour de la période (AAAA-MM-JJ), inclus.",
        "type": [
          "string",
          "null"
        ],
        "format": "date",
        "default": null
      },
      "dossierId": {
        "description": "Identifiant d'un dossier pour n'avoir que ses événements.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "assignee": {
        "description": "Nom ou prénom d'une personne concernée.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "type": {
        "description": "Fragment du libellé du type d'événement (ex. rendez-vous, congé).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "limit": {
        "description": "Nombre de résultats souhaités (10 par défaut, plafonné par le serveur).",
        "type": "integer",
        "default": 10
      },
      "offset": {
        "description": "Nombre de résultats à sauter pour la pagination (0 par défaut).",
        "type": "integer",
        "default": 0
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "totalCount": {
        "description": "Nombre total d'éléments correspondant aux critères.",
        "type": "integer"
      },
      "offset": {
        "description": "Position du premier élément de la page.",
        "type": "integer"
      },
      "limit": {
        "description": "Taille de page appliquée (le serveur plafonne la valeur demandée).",
        "type": "integer"
      },
      "hasMore": {
        "description": "Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.",
        "type": "boolean"
      },
      "items": {
        "description": "Éléments de la page.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "description": "Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event).",
              "type": "integer"
            },
            "kind": {
              "description": "planning ou calendar : écran d'origine de l'événement.",
              "type": "string"
            },
            "subject": {
              "description": "Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.",
              "type": [
                "string",
                "null"
              ]
            },
            "start": {
              "description": "Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).",
              "type": "string",
              "format": "date-time"
            },
            "end": {
              "description": "Fin, en heure locale belge avec son décalage UTC.",
              "type": "string",
              "format": "date-time"
            },
            "type": {
              "description": "Type d'événement (chantier, rendez-vous, congé, intervention…).",
              "type": [
                "string",
                "null"
              ]
            },
            "siteState": {
              "description": "État de chantier (planifié, validé…), pour le planning.",
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "description": "Lieu saisi sur l'événement (masqué pour un événement privé d'autrui).",
              "type": [
                "string",
                "null"
              ]
            },
            "isPrivate": {
              "description": "Vrai pour un événement privé.",
              "type": "boolean"
            },
            "dossierId": {
              "description": "Identifiant du dossier lié (à passer à get_dossier).",
              "type": [
                "integer",
                "null"
              ]
            },
            "dossierReference": {
              "description": "Référence du dossier lié.",
              "type": [
                "string",
                "null"
              ]
            },
            "dossierIndication": {
              "description": "Intitulé court du dossier lié.",
              "type": [
                "string",
                "null"
              ]
            },
            "assignees": {
              "description": "Personnes affectées à cette occurrence.",
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "id",
            "kind",
            "start",
            "end",
            "isPrivate"
          ]
        }
      }
    },
    "required": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Rechercher dans le calendrier",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}