Rechercher des courriels

Nom de l'outilsearch_emails
Lecture seuleIdempotentMonde ouvert

Description

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

Liste ou recherche les courriels de la messagerie Oxygenius (boîtes Microsoft 365 synchronisées), du plus récent au plus ancien, ou ceux classés dans un dossier (dossierId). Chaque dossier de messagerie n'est lisible qu'avec la permission de son écran ; 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. Pour « mes mails », préférer get_my_emails ; pour les mails d'un dossier, list_dossier_emails. Utiliser get_email pour le corps et les pièces jointes.

Accès requis

Paramètres

NomTypePrésenceDescription
querystringfacultatifMots-clés cherchés dans l'objet, le début du texte, l'expéditeur et les destinataires.
folderstringfacultatifinbox (réception, défaut), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), trash (corbeille) ou all (tous les dossiers accessibles). Ignoré avec dossierId.
dossierIdintegerfacultatifIdentifiant d'un dossier pour n'avoir que les courriels classés dans ce dossier.
mailboxstringfacultatifNom ou prénom du titulaire de la boîte aux lettres.
fromstringfacultatifFragment de l'adresse de l'expéditeur (ex. dupont ou @fournisseur.be).
unreadOnlybooleanfacultatifSeulement les courriels non lus (faux par défaut).
Par défaut : false
sincestring (date)facultatifPremier jour (AAAA-MM-JJ).
untilstring (date)facultatifDernier jour (AAAA-MM-JJ), inclus.
limitintegerfacultatifNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Par défaut : 10
offsetintegerfacultatifNombre de résultats à sauter pour la pagination (0 par défaut).
Par défaut : 0

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
totalCountintegerNombre total d'éléments correspondant aux critères.
offsetintegerPosition du premier élément de la page.
limitintegerTaille de page appliquée (le serveur plafonne la valeur demandée).
hasMorebooleanVrai s'il reste des éléments : rappeler l'outil avec offset = offset + limit.
itemsobject[]Éléments de la page.
items[].idintegerIdentifiant du courriel (à passer à get_email).
items[].folderstringinbox (réception), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), draft (brouillon) ou trash (corbeille).
items[].subjectstringpeut être nullObjet.
items[].fromstringpeut être nullAdresse de l'expéditeur.
items[].tostringpeut être nullDestinataires (adresses séparées par « ; »).
items[].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.
items[].isReadbooleanVrai si le courriel a été lu.
items[].hasAttachmentsbooleanVrai si le courriel a des pièces jointes.
items[].mailboxstringpeut être nullTitulaire de la boîte aux lettres où le courriel se trouve.
items[].previewstringpeut être nullDébut du texte.
items[].dossierIdintegerpeut être nullIdentifiant du dossier où le courriel est classé (à passer à get_dossier).
items[].dossierReferencestringpeut être nullRéférence du dossier où le courriel est classé.

Annotations MCP

AnnotationValeurSignification
titleRechercher des courrielsNom 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": "search_emails",
  "title": "Rechercher des courriels",
  "description": "Liste ou recherche les courriels de la messagerie Oxygenius (boîtes Microsoft 365 synchronisées), du plus récent au plus ancien, ou ceux classés dans un dossier (dossierId). Chaque dossier de messagerie n'est lisible qu'avec la permission de son écran ; 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. Pour « mes mails », préférer get_my_emails ; pour les mails d'un dossier, list_dossier_emails. Utiliser get_email pour le corps et les pièces jointes.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "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
      },
      "folder": {
        "description": "inbox (réception, défaut), sent (éléments envoyés), outbox (boîte d'envoi : à envoyer ou en erreur), trash (corbeille) ou all (tous les dossiers accessibles). Ignoré avec dossierId.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "dossierId": {
        "description": "Identifiant d'un dossier pour n'avoir que les courriels classés dans ce dossier.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "mailbox": {
        "description": "Nom ou prénom du titulaire de la boîte aux lettres.",
        "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
      }
    }
  },
  "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": "Rechercher des courriels",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": true,
    "readOnlyHint": true
  }
}