proton_search_emails

Proton Mail · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Ищет `query` в одной папке аккаунта Proton Mail по заголовкам и тексту сообщений, сначала новые. `folder` по умолчанию INBOX; "All Mail" ищет по всем сообщениям. `since` и `until` ограничивают поиск периодом в днях. Поиск выполняет Proton Mail Bridge на этом компьютере. Ничего не помечается как прочитанное. Чтение идёт из Proton Mail Bridge на этом компьютере; нужен тариф Proton, включающий Bridge, при запущенном Bridge.

Обязательные входные данные

query

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для proton_search_emails. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

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

Windows

Назначение

Обязательные входные данные

query

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "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"
}

Пример для документации

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