proton_search_emails

Proton Mail · macOS · Windows

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recherche `query` dans les en-têtes et le texte des messages d’un dossier d’un compte Proton Mail, du plus récent au plus ancien. `folder` vaut INBOX par défaut ; "All Mail" parcourt tous les messages. `since` et `until` restreignent à une période de jours. La recherche est exécutée par Proton Mail Bridge sur cet ordinateur. Rien n’est marqué comme lu. Lu depuis Proton Mail Bridge sur cet ordinateur ; nécessite un forfait Proton incluant Bridge, avec Bridge en cours d’exécution.

Entrées requises

query

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — macOS

{
  "properties": {
    "account": {
      "description": "The Proton Mail account: its address, as proton_connect lists it. Optional when one account is connected.",
      "type": "string"
    },
    "folder": {
      "description": "Folder name (default INBOX).",
      "type": "string"
    },
    "limit": {
      "description": "Messages per page (default 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Matches to skip (default 0).",
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    },
    "since": {
      "description": "Only messages received on or after this day (2026-01-31).",
      "type": "string"
    },
    "until": {
      "description": "Only messages received on or before this day.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour proton_search_emails. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

{
  "folder": "All Mail",
  "limit": 20,
  "query": "launch checklist",
  "since": "2026-10-01"
}

Windows