Courriels d'un dossier
Nom de l'outil
list_dossier_emailsLecture seuleIdempotentMonde ouvert
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.
Accès requis
- Permission :
dossier-detail.tab.mailbox - En plus :
dossier.details.view - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
dossierId | integer | obligatoire | Identifiant du dossier (champ id de search_dossiers). |
query | string | facultatif | Mots-clés cherchés dans l'objet, le début du texte, l'expéditeur et les destinataires. |
from | string | facultatif | Fragment de l'adresse de l'expéditeur (ex. dupont ou @fournisseur.be). |
unreadOnly | boolean | facultatif | Seulement les courriels non lus (faux par défaut). |
since | string (date) | facultatif | Premier jour (AAAA-MM-JJ). |
until | string (date) | facultatif | Dernier jour (AAAA-MM-JJ), inclus. |
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 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 | peut être null | Objet. |
items[].from | string | peut être null | Adresse de l'expéditeur. |
items[].to | string | peut être null | 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 | peut être null | Titulaire de la boîte aux lettres où le courriel se trouve. |
items[].preview | string | peut être null | Début du texte. |
items[].dossierId | integer | peut être null | Identifiant du dossier où le courriel est classé (à passer à get_dossier). |
items[].dossierReference | string | peut être null | Référence du dossier où le courriel est classé. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Courriels d'un dossier | 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 | oui | 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": "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
}
}