Rechercher dans le calendrier

Tool namesearch_calendar_events
Read-onlyIdempotent

Lists or searches calendar events (appointments, office, leave) over a period. Other users' private events show as "Private" without content.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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.

Required access

Parameters

NameTypePresenceDescription
querystringoptionalMots-clés : objet, description, lieu, référence ou intitulé du dossier, nom du client.
fromstring (date)optionalPremier jour de la période (AAAA-MM-JJ).
tostring (date)optionalDernier jour de la période (AAAA-MM-JJ), inclus.
dossierIdintegeroptionalIdentifiant d'un dossier pour n'avoir que ses événements.
assigneestringoptionalNom ou prénom d'une personne concernée.
typestringoptionalFragment du libellé du type d'événement (ex. rendez-vous, congé).
limitintegeroptionalNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Default : 10
offsetintegeroptionalNombre de résultats à sauter pour la pagination (0 par défaut).
Default : 0

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
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[].subjectstringnullableObjet 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[].typestringnullableType d'événement (chantier, rendez-vous, congé, intervention…).
items[].siteStatestringnullableÉtat de chantier (planifié, validé…), pour le planning.
items[].locationstringnullableLieu saisi sur l'événement (masqué pour un événement privé d'autrui).
items[].isPrivatebooleanVrai pour un événement privé.
items[].dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
items[].dossierReferencestringnullableRéférence du dossier lié.
items[].dossierIndicationstringnullableIntitulé court du dossier lié.
items[].assigneesstring[]Personnes affectées à cette occurrence.

MCP annotations

AnnotationValueMeaning
titleRechercher dans le calendrierHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "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
  }
}