Détail d'un courriel

Tool nameget_email
Read-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

Exact text sent to the model by tools/list (French, the language of the data):

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

Parameters

NameTypePresenceDescription
emailIdintegerrequiredIdentifiant 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
NameTypePresenceDescription
ccstringnullableDestinataires en copie.
bccstringnullableDestinataires en copie cachée.
sentAtstring (date-time)nullableDate d'envoi, en heure locale belge.
importancestringnullableImportance (low, normal, high).
typestringnullableType de courriel dans Oxygenius (commande, facture fournisseur…), s'il est classé.
bodystringnullableCorps du courriel, en texte (tronqué au-delà de quelques milliers de caractères).
attachmentsobject[]Pièces jointes (métadonnées).
attachments[].documentIdintegerIdentifiant du document (à passer à read_document ou get_document_download_link).
attachments[].namestringnullableNom du fichier.
attachments[].contentTypestringnullableType MIME.
attachments[].sizeBytesintegerTaille en octets.
attachments[].isInlinebooleanVrai pour une image intégrée au corps (logo, signature).
idintegerIdentifiant du courriel (à passer à get_email).
folderstringinbox (réception), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), draft (brouillon) ou trash (corbeille).
subjectstringnullableObjet.
fromstringnullableAdresse de l'expéditeur.
tostringnullableDestinataires (adresses séparées par « ; »).
datestring (date-time)Date de réception (de création pour un courriel pas encore envoyé), en heure locale belge avec son décalage UTC.
isReadbooleanVrai si le courriel a été lu.
hasAttachmentsbooleanVrai si le courriel a des pièces jointes.
mailboxstringnullableTitulaire de la boîte aux lettres où le courriel se trouve.
previewstringnullableDébut du texte.
dossierIdintegernullableIdentifiant du dossier où le courriel est classé (à passer à get_dossier).
dossierReferencestringnullableRéférence du dossier où le courriel est classé.

MCP annotations

AnnotationValueMeaning
titleDétail d'un courrielHuman-readable name shown by the MCP client.
readOnlyHintyesThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintyesCalling it again with the same arguments has no further effect.
openWorldHintyesThe 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
  }
}