Détail d'un courriel
Tool name
get_emailRead-onlyIdempotentOpen world
Returns an e-mail: sender, recipients, dates, project, plain-text body and attachment metadata. The e-mail is not marked as read.
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.
Required access
- At least one of these permissions:
mail-inbox.list.viewormail-outbox.list.viewormail-sendbox.list.viewormail-trashbox.list.vieworall-mail.list.viewordossier-detail.tab.mailbox - Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
emailId | integer | required | Identifiant du courriel (champ id de search_emails ou get_my_emails). |
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 |
|---|---|---|---|
cc | string | nullable | Destinataires en copie. |
bcc | string | nullable | Destinataires en copie cachée. |
sentAt | string (date-time) | nullable | Date d'envoi, en heure locale belge. |
importance | string | nullable | Importance (low, normal, high). |
type | string | nullable | Type de courriel dans Oxygenius (commande, facture fournisseur…), s'il est classé. |
body | string | nullable | 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 | nullable | Nom du fichier. |
attachments[].contentType | string | nullable | 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 | nullable | Objet. |
from | string | nullable | Adresse de l'expéditeur. |
to | string | nullable | 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 | nullable | Titulaire de la boîte aux lettres où le courriel se trouve. |
preview | string | nullable | Début du texte. |
dossierId | integer | nullable | Identifiant du dossier où le courriel est classé (à passer à get_dossier). |
dossierReference | string | nullable | Référence du dossier où le courriel est classé. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Détail d'un courriel | 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": "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
}
}