m365_search_emails
Microsoft 365 · macOS · Windows
Efeito: leitura. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Use isto quando o usuário quiser encontrar e-mails em sua caixa de correio do Microsoft 365/Outlook por meio da nuvem — requer uma conta M365 conectada. Por padrão, pesquisa remetente, assunto, corpo AND (padrão $search do próprio Microsoft Graph). Passe scope="metadata" para pesquisar apenas o remetente/assunto (mais rápido, sem verificação do corpo) ou scope="body" para pesquisar apenas o corpo da mensagem. Para contas adicionadas ao Mail.app do Mac, use search_emails.
Entradas obrigatórias
query
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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"
}Exemplo documental
Exemplo de documentação para m365_search_emails. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"query": "launch checklist"
}Windows
Finalidade
Pesquise seus emails do Microsoft 365 por palavra-chave, remetente ou assunto.
Entradas obrigatórias
query
Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em 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"
}Exemplo documental
Exemplo de documentação para m365_search_emails. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{
"query": "launch checklist"
}