Rechercher des tâches
search_tasksLists or searches the tasks visible to the user, urgent ones first; to-do tasks by default.
Description
Liste ou recherche les tâches Oxygenius (demandes adressées d'un utilisateur à un autre, souvent liées à un dossier), urgentes d'abord puis les plus récentes. Par défaut : les tâches à traiter. Seules les tâches visibles dans l'application sont renvoyées : celles dont l'utilisateur est destinataire, expéditeur ou créateur, et avec le droit de voir les tâches des autres, toutes celles des dossiers. Pour « mes tâches », préférer get_my_tasks. Utiliser get_task pour le détail et l'historique de l'échange.
Required access
- At least one of these permissions:
dashboard.tasksWidget.viewordossier-detail.tab.task - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
query | string | optional | Mots-clés : contenu, titre, type de tâche, référence ou intitulé du dossier. |
status | string | optional | open (à traiter, défaut), scheduled (planifiées), done (traitées : répondues, transférées ou clôturées) ou all. |
dossierId | integer | optional | Identifiant d'un dossier pour n'avoir que ses tâches. |
assignee | string | optional | Nom ou prénom du destinataire. |
sender | string | optional | Nom ou prénom de l'expéditeur. |
overdueOnly | boolean | optional | Seulement les tâches à traiter en retard (faux par défaut). |
limit | integer | optional | Nombre de résultats souhaités (10 par défaut, plafonné par le serveur). |
offset | integer | optional | Nombre de résultats à sauter pour la pagination (0 par défaut). |
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 |
|---|---|---|---|
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 la tâche (à passer à get_task). | |
items[].status | string | open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée). | |
items[].type | string | nullable | Type de tâche (catégorie), ex. Commande, Facturation. |
items[].title | string | nullable | Titre, rarement renseigné. |
items[].description | string | nullable | Contenu de la tâche, en texte (tronqué dans les listes). |
items[].isUrgent | boolean | Vrai pour une tâche urgente (épinglée). | |
items[].isOverdue | boolean | Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application). | |
items[].from | string | nullable | Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique). |
items[].to | string | nullable | Destinataire. |
items[].createdAt | string (date-time) | Date de création, en heure locale belge avec son décalage UTC. | |
items[].dueDate | string (date) | nullable | Échéance (AAAA-MM-JJ), rarement renseignée. |
items[].scheduledFor | string (date) | nullable | Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ). |
items[].completedAt | string (date-time) | nullable | Date à laquelle la tâche a été traitée, en heure locale belge. |
items[].dossierId | integer | nullable | Identifiant du dossier lié (à passer à get_dossier). |
items[].dossierReference | string | nullable | Référence du dossier lié. |
items[].dossierIndication | string | nullable | Intitulé court du dossier lié. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Rechercher des tâches | Human-readable name shown by the MCP client. |
readOnlyHint | yes | The tool changes nothing. |
destructiveHint | no | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | 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": "search_tasks",
"title": "Rechercher des tâches",
"description": "Liste ou recherche les tâches Oxygenius (demandes adressées d'un utilisateur à un autre, souvent liées à un dossier), urgentes d'abord puis les plus récentes. Par défaut : les tâches à traiter. Seules les tâches visibles dans l'application sont renvoyées : celles dont l'utilisateur est destinataire, expéditeur ou créateur, et avec le droit de voir les tâches des autres, toutes celles des dossiers. Pour « mes tâches », préférer get_my_tasks. Utiliser get_task pour le détail et l'historique de l'échange.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"description": "Mots-clés : contenu, titre, type de tâche, référence ou intitulé du dossier.",
"type": [
"string",
"null"
],
"default": null
},
"status": {
"description": "open (à traiter, défaut), scheduled (planifiées), done (traitées : répondues, transférées ou clôturées) ou all.",
"type": [
"string",
"null"
],
"default": null
},
"dossierId": {
"description": "Identifiant d'un dossier pour n'avoir que ses tâches.",
"type": [
"integer",
"null"
],
"default": null
},
"assignee": {
"description": "Nom ou prénom du destinataire.",
"type": [
"string",
"null"
],
"default": null
},
"sender": {
"description": "Nom ou prénom de l'expéditeur.",
"type": [
"string",
"null"
],
"default": null
},
"overdueOnly": {
"description": "Seulement les tâches à traiter en retard (faux par défaut).",
"type": "boolean",
"default": false
},
"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 la tâche (à passer à get_task).",
"type": "integer"
},
"status": {
"description": "open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).",
"type": "string"
},
"type": {
"description": "Type de tâche (catégorie), ex. Commande, Facturation.",
"type": [
"string",
"null"
]
},
"title": {
"description": "Titre, rarement renseigné.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Contenu de la tâche, en texte (tronqué dans les listes).",
"type": [
"string",
"null"
]
},
"isUrgent": {
"description": "Vrai pour une tâche urgente (épinglée).",
"type": "boolean"
},
"isOverdue": {
"description": "Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).",
"type": "boolean"
},
"from": {
"description": "Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).",
"type": [
"string",
"null"
]
},
"to": {
"description": "Destinataire.",
"type": [
"string",
"null"
]
},
"createdAt": {
"description": "Date de création, en heure locale belge avec son décalage UTC.",
"type": "string",
"format": "date-time"
},
"dueDate": {
"description": "Échéance (AAAA-MM-JJ), rarement renseignée.",
"type": [
"string",
"null"
],
"format": "date"
},
"scheduledFor": {
"description": "Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).",
"type": [
"string",
"null"
],
"format": "date"
},
"completedAt": {
"description": "Date à laquelle la tâche a été traitée, en heure locale belge.",
"type": [
"string",
"null"
],
"format": "date-time"
},
"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"
]
}
},
"required": [
"id",
"status",
"isUrgent",
"isOverdue",
"createdAt"
]
}
}
},
"required": [
"totalCount",
"offset",
"limit",
"hasMore",
"items"
]
},
"annotations": {
"title": "Rechercher des tâches",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": true
}
}