Courriels d'un dossier
Tool name
list_dossier_emailsRead-onlyIdempotentOpen world
Lists the e-mails filed in a project, like its Mails tab.
Description
Liste les courriels classés dans un dossier Oxygenius, comme son onglet Mails : reçus et envoyés, hors corbeille, du plus récent au plus ancien. Si la société limite l'accès aux boîtes partagées, seuls les courriels de la boîte de l'utilisateur et de celles partagées avec lui sont renvoyés. Utiliser get_email pour le corps et les pièces jointes.
Required access
- Permission:
dossier-detail.tab.mailbox - In addition:
dossier.details.view - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
dossierId | integer | required | Identifiant du dossier (champ id de search_dossiers). |
query | string | optional | Mots-clés cherchés dans l'objet, le début du texte, l'expéditeur et les destinataires. |
from | string | optional | Fragment de l'adresse de l'expéditeur (ex. dupont ou @fournisseur.be). |
unreadOnly | boolean | optional | Seulement les courriels non lus (faux par défaut). |
since | string (date) | optional | Premier jour (AAAA-MM-JJ). |
until | string (date) | optional | Dernier jour (AAAA-MM-JJ), inclus. |
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 du courriel (à passer à get_email). | |
items[].folder | string | inbox (réception), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), draft (brouillon) ou trash (corbeille). | |
items[].subject | string | nullable | Objet. |
items[].from | string | nullable | Adresse de l'expéditeur. |
items[].to | string | nullable | Destinataires (adresses séparées par « ; »). |
items[].date | string (date-time) | Date de réception (de création pour un courriel pas encore envoyé), en heure locale belge avec son décalage UTC. | |
items[].isRead | boolean | Vrai si le courriel a été lu. | |
items[].hasAttachments | boolean | Vrai si le courriel a des pièces jointes. | |
items[].mailbox | string | nullable | Titulaire de la boîte aux lettres où le courriel se trouve. |
items[].preview | string | nullable | Début du texte. |
items[].dossierId | integer | nullable | Identifiant du dossier où le courriel est classé (à passer à get_dossier). |
items[].dossierReference | string | nullable | Référence du dossier où le courriel est classé. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Courriels d'un dossier | 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 | yes | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "list_dossier_emails",
"title": "Courriels d'un dossier",
"description": "Liste les courriels classés dans un dossier Oxygenius, comme son onglet Mails : reçus et envoyés, hors corbeille, du plus récent au plus ancien. Si la société limite l'accès aux boîtes partagées, seuls les courriels de la boîte de l'utilisateur et de celles partagées avec lui sont renvoyés. Utiliser get_email pour le corps et les pièces jointes.",
"inputSchema": {
"type": "object",
"properties": {
"dossierId": {
"description": "Identifiant du dossier (champ id de search_dossiers).",
"type": "integer"
},
"query": {
"description": "Mots-clés cherchés dans l'objet, le début du texte, l'expéditeur et les destinataires.",
"type": [
"string",
"null"
],
"default": null
},
"from": {
"description": "Fragment de l'adresse de l'expéditeur (ex. dupont ou @fournisseur.be).",
"type": [
"string",
"null"
],
"default": null
},
"unreadOnly": {
"description": "Seulement les courriels non lus (faux par défaut).",
"type": "boolean",
"default": false
},
"since": {
"description": "Premier jour (AAAA-MM-JJ).",
"type": [
"string",
"null"
],
"format": "date",
"default": null
},
"until": {
"description": "Dernier jour (AAAA-MM-JJ), inclus.",
"type": [
"string",
"null"
],
"format": "date",
"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
}
},
"required": [
"dossierId"
]
},
"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 du courriel (à passer à get_email).",
"type": "integer"
},
"folder": {
"description": "inbox (réception), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), draft (brouillon) ou trash (corbeille).",
"type": "string"
},
"subject": {
"description": "Objet.",
"type": [
"string",
"null"
]
},
"from": {
"description": "Adresse de l'expéditeur.",
"type": [
"string",
"null"
]
},
"to": {
"description": "Destinataires (adresses séparées par « ; »).",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date de réception (de création pour un courriel pas encore envoyé), en heure locale belge avec son décalage UTC.",
"type": "string",
"format": "date-time"
},
"isRead": {
"description": "Vrai si le courriel a été lu.",
"type": "boolean"
},
"hasAttachments": {
"description": "Vrai si le courriel a des pièces jointes.",
"type": "boolean"
},
"mailbox": {
"description": "Titulaire de la boîte aux lettres où le courriel se trouve.",
"type": [
"string",
"null"
]
},
"preview": {
"description": "Début du texte.",
"type": [
"string",
"null"
]
},
"dossierId": {
"description": "Identifiant du dossier où le courriel est classé (à passer à get_dossier).",
"type": [
"integer",
"null"
]
},
"dossierReference": {
"description": "Référence du dossier où le courriel est classé.",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"folder",
"date",
"isRead",
"hasAttachments"
]
}
}
},
"required": [
"totalCount",
"offset",
"limit",
"hasMore",
"items"
]
},
"annotations": {
"title": "Courriels d'un dossier",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true,
"readOnlyHint": true
}
}