m365_search_emails
Microsoft 365 · 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
Úselo cuando el usuario quiera buscar correos electrónicos en su buzón de correo de Microsoft 365/Outlook a través de la nube; requiere una cuenta M365 conectada. De forma predeterminada, busca remitente, asunto, cuerpo (el comportamiento predeterminado del operador `$search` de Microsoft Graph). Pase scope="metadata" para buscar solo el remitente/asunto (más rápido, sin escaneo del cuerpo), o scope="body" para buscar solo el cuerpo del mensaje. Para cuentas agregadas a Mail.app de Mac, use search_emails.
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": {
"limit": {
"description": "Max results (default 20, max 50)",
"type": "integer"
},
"query": {
"description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
"type": "string"
},
"scope": {
"description": "\"all\" (default — sender+subject+body, today's behavior), \"metadata\" (sender+subject only), or \"body\" (body only).",
"enum": [
"metadata",
"body",
"all"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para m365_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.
{
"query": "launch checklist"
}Windows
Propósito
Busque sus correos electrónicos de Microsoft 365 por palabra clave, remitente o asunto.
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 — Windows
{
"properties": {
"limit": {
"description": "Max results (default 20, max 50)",
"type": "number"
},
"query": {
"description": "Search query, e.g. 'budget Q2', 'from:[email protected]', 'subject:invoice'",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Ejemplo documental
Ejemplo de documentación para m365_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.
{
"query": "launch checklist"
}