Détail d'un courriel
Nom de l'outil
get_emailLecture seuleIdempotentMonde ouvert
Description
Renvoie un courriel : expéditeur, destinataires, copies, dates, dossier où il est classé, corps en texte et pièces jointes (nom, type, taille ; read_document en lit le contenu). Le courriel n'est pas marqué comme lu.
Accès requis
- Au moins une de ces permissions :
mail-inbox.list.viewoumail-outbox.list.viewoumail-sendbox.list.viewoumail-trashbox.list.viewouall-mail.list.viewoudossier-detail.tab.mailbox - Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
emailId | integer | obligatoire | Identifiant du courriel (champ id de search_emails ou get_my_emails). |
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 |
|---|---|---|---|
cc | string | peut être null | Destinataires en copie. |
bcc | string | peut être null | Destinataires en copie cachée. |
sentAt | string (date-time) | peut être null | Date d'envoi, en heure locale belge. |
importance | string | peut être null | Importance (low, normal, high). |
type | string | peut être null | Type de courriel dans Oxygenius (commande, facture fournisseur…), s'il est classé. |
body | string | peut être null | Corps du courriel, en texte (tronqué au-delà de quelques milliers de caractères). |
attachments | object[] | Pièces jointes (métadonnées). | |
attachments[].documentId | integer | Identifiant du document (à passer à read_document ou get_document_download_link). | |
attachments[].name | string | peut être null | Nom du fichier. |
attachments[].contentType | string | peut être null | Type MIME. |
attachments[].sizeBytes | integer | Taille en octets. | |
attachments[].isInline | boolean | Vrai pour une image intégrée au corps (logo, signature). | |
id | integer | Identifiant du courriel (à passer à get_email). | |
folder | string | inbox (réception), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), draft (brouillon) ou trash (corbeille). | |
subject | string | peut être null | Objet. |
from | string | peut être null | Adresse de l'expéditeur. |
to | string | peut être null | Destinataires (adresses séparées par « ; »). |
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. | |
isRead | boolean | Vrai si le courriel a été lu. | |
hasAttachments | boolean | Vrai si le courriel a des pièces jointes. | |
mailbox | string | peut être null | Titulaire de la boîte aux lettres où le courriel se trouve. |
preview | string | peut être null | Début du texte. |
dossierId | integer | peut être null | Identifiant du dossier où le courriel est classé (à passer à get_dossier). |
dossierReference | string | peut être null | Référence du dossier où le courriel est classé. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Détail d'un courriel | 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": "get_email",
"title": "Détail d'un courriel",
"description": "Renvoie un courriel : expéditeur, destinataires, copies, dates, dossier où il est classé, corps en texte et pièces jointes (nom, type, taille ; read_document en lit le contenu). Le courriel n'est pas marqué comme lu.",
"inputSchema": {
"type": "object",
"properties": {
"emailId": {
"description": "Identifiant du courriel (champ id de search_emails ou get_my_emails).",
"type": "integer"
}
},
"required": [
"emailId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"cc": {
"description": "Destinataires en copie.",
"type": [
"string",
"null"
]
},
"bcc": {
"description": "Destinataires en copie cachée.",
"type": [
"string",
"null"
]
},
"sentAt": {
"description": "Date d'envoi, en heure locale belge.",
"type": [
"string",
"null"
],
"format": "date-time"
},
"importance": {
"description": "Importance (low, normal, high).",
"type": [
"string",
"null"
]
},
"type": {
"description": "Type de courriel dans Oxygenius (commande, facture fournisseur…), s'il est classé.",
"type": [
"string",
"null"
]
},
"body": {
"description": "Corps du courriel, en texte (tronqué au-delà de quelques milliers de caractères).",
"type": [
"string",
"null"
]
},
"attachments": {
"description": "Pièces jointes (métadonnées).",
"type": "array",
"items": {
"type": "object",
"properties": {
"documentId": {
"description": "Identifiant du document (à passer à read_document ou get_document_download_link).",
"type": "integer"
},
"name": {
"description": "Nom du fichier.",
"type": [
"string",
"null"
]
},
"contentType": {
"description": "Type MIME.",
"type": [
"string",
"null"
]
},
"sizeBytes": {
"description": "Taille en octets.",
"type": "integer"
},
"isInline": {
"description": "Vrai pour une image intégrée au corps (logo, signature).",
"type": "boolean"
}
},
"required": [
"documentId",
"sizeBytes",
"isInline"
]
}
},
"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"
]
},
"annotations": {
"title": "Détail d'un courriel",
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true,
"readOnlyHint": true
}
}