Détail d'un courriel

Nom de l'outilget_email
Lecture seuleIdempotentMonde ouvert

Description

Texte exact envoyé au modèle par tools/list :

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

Paramètres

NomTypePrésenceDescription
emailIdintegerobligatoireIdentifiant 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
NomTypePrésenceDescription
ccstringpeut être nullDestinataires en copie.
bccstringpeut être nullDestinataires en copie cachée.
sentAtstring (date-time)peut être nullDate d'envoi, en heure locale belge.
importancestringpeut être nullImportance (low, normal, high).
typestringpeut être nullType de courriel dans Oxygenius (commande, facture fournisseur…), s'il est classé.
bodystringpeut être nullCorps 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[].namestringpeut être nullNom du fichier.
attachments[].contentTypestringpeut être nullType 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).
subjectstringpeut être nullObjet.
fromstringpeut être nullAdresse de l'expéditeur.
tostringpeut être nullDestinataires (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.
mailboxstringpeut être nullTitulaire de la boîte aux lettres où le courriel se trouve.
previewstringpeut être nullDébut du texte.
dossierIdintegerpeut être nullIdentifiant du dossier où le courriel est classé (à passer à get_dossier).
dossierReferencestringpeut être nullRéférence du dossier où le courriel est classé.

Annotations MCP

AnnotationValeurSignification
titleDétail d'un courrielNom lisible affiché par le client MCP.
readOnlyHintouiL'outil ne modifie rien.
destructiveHintnonL'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible.
idempotentHintouiRappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire.
openWorldHintouiL'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
  }
}