Rechercher dans le calendrier
search_calendar_eventsDescription
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
- Au moins une de ces permissions :
calendar.list.viewoucalendar-hybrid.list.view - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
query | string | facultatif | Mots-clés : objet, description, lieu, référence ou intitulé du dossier, nom du client. |
from | string (date) | facultatif | Premier jour de la période (AAAA-MM-JJ). |
to | string (date) | facultatif | Dernier jour de la période (AAAA-MM-JJ), inclus. |
dossierId | integer | facultatif | Identifiant d'un dossier pour n'avoir que ses événements. |
assignee | string | facultatif | Nom ou prénom d'une personne concernée. |
type | string | facultatif | Fragment du libellé du type d'événement (ex. rendez-vous, congé). |
limit | integer | facultatif | Nombre de résultats souhaités (10 par défaut, plafonné par le serveur). |
offset | integer | facultatif | Nombre de résultats à sauter pour la pagination (0 par défaut). |
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
| Nom | Type | Présence | Description |
|---|---|---|---|
totalCount | integer | Nombre total d'éléments correspondant aux critères. | |
offset | integer | Position du premier élément de la page. | |
limit | integer | Taille de page appliquée (le serveur plafonne la valeur demandée). | |
hasMore | boolean | Vrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit. | |
items | object[] | Éléments de la page. | |
items[].id | integer | Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event). | |
items[].kind | string | planning ou calendar : écran d'origine de l'événement. | |
items[].subject | string | peut être null | Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur. |
items[].start | string (date-time) | Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00). | |
items[].end | string (date-time) | Fin, en heure locale belge avec son décalage UTC. | |
items[].type | string | peut être null | Type d'événement (chantier, rendez-vous, congé, intervention…). |
items[].siteState | string | peut être null | État de chantier (planifié, validé…), pour le planning. |
items[].location | string | peut être null | Lieu saisi sur l'événement (masqué pour un événement privé d'autrui). |
items[].isPrivate | boolean | Vrai pour un événement privé. | |
items[].dossierId | integer | peut être null | Identifiant du dossier lié (à passer à get_dossier). |
items[].dossierReference | string | peut être null | Référence du dossier lié. |
items[].dossierIndication | string | peut être null | Intitulé court du dossier lié. |
items[].assignees | string[] | Personnes affectées à cette occurrence. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Rechercher dans le calendrier | Nom lisible affiché par le client MCP. |
readOnlyHint | oui | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'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
}
}