thunderbird_search_emails

Thunderbird · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Busca en los mensajes de una cuenta de Thunderbird el texto `query` en asunto, remitente, destinatarios y cuerpo, sin distinguir mayúsculas ni acentos, del más nuevo al más antiguo dentro de cada carpeta. `folder` la limita a una carpeta; `since` y `until`, a un período. Los mensajes se leen de los archivos de correo, así que un buzón grande se busca hasta un límite: `complete` indica si se buscó en todo y `folders_not_searched` nombra lo que no se buscó. Un mensaje de más de 4 MB solo se compara por sus encabezados. Solo se ven los mensajes almacenados en este equipo: en una cuenta IMAP, eso es lo que Thunderbird ha descargado, no todo lo que hay en el servidor.

Entradas obligatorias

query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "account": {
      "description": "Account id, name or address from thunderbird_list_accounts. Optional when the profile has one mail account.",
      "type": "string"
    },
    "folder": {
      "description": "Folder path. Optional: every folder of the account, INBOX first.",
      "type": "string"
    },
    "limit": {
      "description": "Messages per page (default 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Matches to skip (default 0).",
      "type": "integer"
    },
    "profile": {
      "description": "Thunderbird profile name. Optional: the default profile is used.",
      "type": "string"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    },
    "since": {
      "description": "Only messages dated on or after this day or instant (2026-01-31 or 2026-01-31T10:00:00Z).",
      "type": "string"
    },
    "until": {
      "description": "Only messages dated on or before this day or instant.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para thunderbird_search_emails. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "account": "alex@example.com",
  "query": "launch checklist",
  "since": "2026-10-01"
}

Windows