Ajouter un événement au calendrier
create_calendar_eventCreates a calendar event on one day or consecutive days for one or more people. No confirmation is sent to the customer.
Description
Crée dans le calendrier Oxygenius un événement (rendez-vous, bureau, congé…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, pour une ou plusieurs personnes (get_agenda_lists avec kind calendar donne les types et les calendriers accessibles). Un événement de type privé n'est visible que de ses personnes et de son auteur. Lié à un dossier, il a lieu par défaut à l'adresse de son chantier et, comme dans l'application, un premier rendez-vous fait avancer les étapes du dossier (prise de contact). Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.
Required access
- At least one of these permissions:
calendar.list.vieworcalendar-hybrid.list.view - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
subject | string | required | Objet de l'événement (ex. Visite chez le client). |
date | string (date) | required | Premier jour (AAAA-MM-JJ). |
startTime | string | required | Heure de début, heure locale belge (HH:mm, ex. 14:00). |
endTime | string | required | Heure de fin, le même jour (HH:mm). |
resourceIds | integer[] | required | Personnes concernées (champ id de resources dans get_agenda_lists), 20 au plus. |
endDate | string (date) | optional | Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus). |
typeId | integer | optional | Type d'événement (id de types) ; par défaut, le type marqué isDefault. |
dossierId | integer | optional | Dossier lié (champ id de search_dossiers). |
location | string | optional | Lieu ; par défaut, l'adresse du chantier du dossier lié. |
description | string | optional | Description, en texte simple. |
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
| Name | Type | Presence | Description |
|---|---|---|---|
description | string | nullable | Description de l'événement (masquée pour un événement privé d'autrui). |
dossierSiteAddress | string | nullable | Adresse du chantier du dossier lié. |
dossierClient | string | nullable | Client (tiers propriétaire) du dossier lié. |
estimates | object[] | Devis liés à l'événement (vide sans accès aux devis). | |
estimates[].estimateId | integer | Identifiant du devis (à passer à get_estimate). | |
estimates[].reference | string | nullable | Référence du devis. |
id | integer | Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event). | |
kind | string | planning ou calendar : écran d'origine de l'événement. | |
subject | string | nullable | Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur. |
start | string (date-time) | Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00). | |
end | string (date-time) | Fin, en heure locale belge avec son décalage UTC. | |
type | string | nullable | Type d'événement (chantier, rendez-vous, congé, intervention…). |
siteState | string | nullable | État de chantier (planifié, validé…), pour le planning. |
location | string | nullable | Lieu saisi sur l'événement (masqué pour un événement privé d'autrui). |
isPrivate | boolean | Vrai pour un événement privé. | |
dossierId | integer | nullable | Identifiant du dossier lié (à passer à get_dossier). |
dossierReference | string | nullable | Référence du dossier lié. |
dossierIndication | string | nullable | Intitulé court du dossier lié. |
assignees | string[] | Personnes affectées à cette occurrence. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Ajouter un événement au calendrier | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | no | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "create_calendar_event",
"title": "Ajouter un événement au calendrier",
"description": "Crée dans le calendrier Oxygenius un événement (rendez-vous, bureau, congé…) sur un jour ou sur plusieurs jours consécutifs, aux mêmes heures chaque jour, pour une ou plusieurs personnes (get_agenda_lists avec kind calendar donne les types et les calendriers accessibles). Un événement de type privé n'est visible que de ses personnes et de son auteur. Lié à un dossier, il a lieu par défaut à l'adresse de son chantier et, comme dans l'application, un premier rendez-vous fait avancer les étapes du dossier (prise de contact). Avant l'appel, annoncer précisément l'événement (jours, heures, personnes) et attendre l'accord de l'utilisateur. Aucune confirmation n'est envoyée au client ; les personnes affectées sont prévenues par l'application. Ne pas rappeler l'outil après un succès : chaque appel crée un nouvel événement. Renvoie le premier jour créé.",
"inputSchema": {
"type": "object",
"properties": {
"subject": {
"description": "Objet de l'événement (ex. Visite chez le client).",
"type": "string"
},
"date": {
"description": "Premier jour (AAAA-MM-JJ).",
"type": "string",
"format": "date"
},
"startTime": {
"description": "Heure de début, heure locale belge (HH:mm, ex. 14:00).",
"type": "string"
},
"endTime": {
"description": "Heure de fin, le même jour (HH:mm).",
"type": "string"
},
"resourceIds": {
"description": "Personnes concernées (champ id de resources dans get_agenda_lists), 20 au plus.",
"type": "array",
"items": {
"type": "integer"
}
},
"endDate": {
"description": "Dernier jour, pour un événement de plusieurs jours consécutifs (31 jours au plus).",
"type": [
"string",
"null"
],
"format": "date",
"default": null
},
"typeId": {
"description": "Type d'événement (id de types) ; par défaut, le type marqué isDefault.",
"type": [
"integer",
"null"
],
"default": null
},
"dossierId": {
"description": "Dossier lié (champ id de search_dossiers).",
"type": [
"integer",
"null"
],
"default": null
},
"location": {
"description": "Lieu ; par défaut, l'adresse du chantier du dossier lié.",
"type": [
"string",
"null"
],
"default": null
},
"description": {
"description": "Description, en texte simple.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"subject",
"date",
"startTime",
"endTime",
"resourceIds"
]
},
"outputSchema": {
"type": "object",
"properties": {
"description": {
"description": "Description de l'événement (masquée pour un événement privé d'autrui).",
"type": [
"string",
"null"
]
},
"dossierSiteAddress": {
"description": "Adresse du chantier du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierClient": {
"description": "Client (tiers propriétaire) du dossier lié.",
"type": [
"string",
"null"
]
},
"estimates": {
"description": "Devis liés à l'événement (vide sans accès aux devis).",
"type": "array",
"items": {
"type": "object",
"properties": {
"estimateId": {
"description": "Identifiant du devis (à passer à get_estimate).",
"type": "integer"
},
"reference": {
"description": "Référence du devis.",
"type": [
"string",
"null"
]
}
},
"required": [
"estimateId"
]
}
},
"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"
]
},
"annotations": {
"title": "Ajouter un événement au calendrier",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}