Rechercher des courriels

Tool namesearch_emails
Read-onlyIdempotentOpen world

Lists or searches e-mails of the Oxygenius mailbox (synchronised Microsoft 365 mailboxes), or those filed in a project.

Description

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

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.

Required access

Parameters

NameTypePresenceDescription
querystringoptionalMots-clés cherchés dans l'objet, le début du texte, l'expéditeur et les destinataires.
folderstringoptionalinbox (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.
dossierIdintegeroptionalIdentifiant d'un dossier pour n'avoir que les courriels classés dans ce dossier.
mailboxstringoptionalNom ou prénom du titulaire de la boîte aux lettres.
fromstringoptionalFragment de l'adresse de l'expéditeur (ex. dupont ou @fournisseur.be).
unreadOnlybooleanoptionalSeulement les courriels non lus (faux par défaut).
Default : false
sincestring (date)optionalPremier jour (AAAA-MM-JJ).
untilstring (date)optionalDernier jour (AAAA-MM-JJ), inclus.
limitintegeroptionalNombre de résultats souhaités (10 par défaut, plafonné par le serveur).
Default : 10
offsetintegeroptionalNombre de résultats à sauter pour la pagination (0 par défaut).
Default : 0

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
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[].subjectstringnullableObjet.
items[].fromstringnullableAdresse de l'expéditeur.
items[].tostringnullableDestinataires (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[].mailboxstringnullableTitulaire de la boîte aux lettres où le courriel se trouve.
items[].previewstringnullableDébut du texte.
items[].dossierIdintegernullableIdentifiant du dossier où le courriel est classé (à passer à get_dossier).
items[].dossierReferencestringnullableRéférence du dossier où le courriel est classé.

MCP annotations

AnnotationValueMeaning
titleRechercher des courrielsHuman-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": "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
  }
}