Mes tâches

Tool nameget_my_tasks
Read-onlyIdempotent

Returns the signed-in user's tasks, like the dashboard widget: received, sent or scheduled.

Description

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

Renvoie les tâches de l'utilisateur connecté, comme le widget Tâches de son tableau de bord : par défaut celles qu'il a reçues et doit traiter, sinon celles qu'il a envoyées et qui ne sont pas encore traitées, ou celles qui lui sont planifiées. Urgentes d'abord, puis les plus récentes.

Required access

Parameters

NameTypePresenceDescription
boxstringoptionalreceived (reçues à traiter, défaut), sent (envoyées, en cours) ou scheduled (reçues, planifiées pour plus tard).
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 de la tâche (à passer à get_task).
items[].statusstringopen (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).
items[].typestringnullableType de tâche (catégorie), ex. Commande, Facturation.
items[].titlestringnullableTitre, rarement renseigné.
items[].descriptionstringnullableContenu de la tâche, en texte (tronqué dans les listes).
items[].isUrgentbooleanVrai pour une tâche urgente (épinglée).
items[].isOverduebooleanVrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).
items[].fromstringnullableExpéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).
items[].tostringnullableDestinataire.
items[].createdAtstring (date-time)Date de création, en heure locale belge avec son décalage UTC.
items[].dueDatestring (date)nullableÉchéance (AAAA-MM-JJ), rarement renseignée.
items[].scheduledForstring (date)nullableDate à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).
items[].completedAtstring (date-time)nullableDate à laquelle la tâche a été traitée, en heure locale belge.
items[].dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
items[].dossierReferencestringnullableRéférence du dossier lié.
items[].dossierIndicationstringnullableIntitulé court du dossier lié.

MCP annotations

AnnotationValueMeaning
titleMes tâchesHuman-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.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "get_my_tasks",
  "title": "Mes tâches",
  "description": "Renvoie les tâches de l'utilisateur connecté, comme le widget Tâches de son tableau de bord : par défaut celles qu'il a reçues et doit traiter, sinon celles qu'il a envoyées et qui ne sont pas encore traitées, ou celles qui lui sont planifiées. Urgentes d'abord, puis les plus récentes.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "box": {
        "description": "received (reçues à traiter, défaut), sent (envoyées, en cours) ou scheduled (reçues, planifiées pour plus tard).",
        "type": [
          "string",
          "null"
        ],
        "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 de la tâche (à passer à get_task).",
              "type": "integer"
            },
            "status": {
              "description": "open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).",
              "type": "string"
            },
            "type": {
              "description": "Type de tâche (catégorie), ex. Commande, Facturation.",
              "type": [
                "string",
                "null"
              ]
            },
            "title": {
              "description": "Titre, rarement renseigné.",
              "type": [
                "string",
                "null"
              ]
            },
            "description": {
              "description": "Contenu de la tâche, en texte (tronqué dans les listes).",
              "type": [
                "string",
                "null"
              ]
            },
            "isUrgent": {
              "description": "Vrai pour une tâche urgente (épinglée).",
              "type": "boolean"
            },
            "isOverdue": {
              "description": "Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).",
              "type": "boolean"
            },
            "from": {
              "description": "Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).",
              "type": [
                "string",
                "null"
              ]
            },
            "to": {
              "description": "Destinataire.",
              "type": [
                "string",
                "null"
              ]
            },
            "createdAt": {
              "description": "Date de création, en heure locale belge avec son décalage UTC.",
              "type": "string",
              "format": "date-time"
            },
            "dueDate": {
              "description": "Échéance (AAAA-MM-JJ), rarement renseignée.",
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "scheduledFor": {
              "description": "Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).",
              "type": [
                "string",
                "null"
              ],
              "format": "date"
            },
            "completedAt": {
              "description": "Date à laquelle la tâche a été traitée, en heure locale belge.",
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "dossierId": {
              "description": "Identifiant du dossier lié (à passer à get_dossier).",
              "type": [
                "integer",
                "null"
              ]
            },
            "dossierReference": {
              "description": "Référence du dossier lié.",
              "type": [
                "string",
                "null"
              ]
            },
            "dossierIndication": {
              "description": "Intitulé court du dossier lié.",
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "status",
            "isUrgent",
            "isOverdue",
            "createdAt"
          ]
        }
      }
    },
    "required": [
      "totalCount",
      "offset",
      "limit",
      "hasMore",
      "items"
    ]
  },
  "annotations": {
    "title": "Mes tâches",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": true
  }
}