list_email_folders

macOS

Finalidade

Lista a árvore completa de pastas (caixa de correio) para contas Apple Mail (Mail.app), incluindo subpastas aninhadas. Use isso para descobrir os nomes exatos das pastas que move_email(target_mailbox=...) e list_emails(mailbox=...) esperam. As contas Outlook.com, Exchange, Gmail, iCloud e IMAP adicionadas ao Mail.app estão todas incluídas. Para uma caixa de correio do Microsoft 365 somente Graph não adicionada ao Mail.app, use m365_list_emails. Passe account=<name> (de list_email_accounts) para enumerar uma conta completamente; sem ele, todas as contas são percorridas, o que pode ser lento no macOS 15+. As contagens de mensagens estão desativadas por padrão (lento em IMAP) — passe include_counts=true para adicionar não lidas/total por pasta.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

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.

{
  "properties": {
    "account": {
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "type": "boolean"
    }
  },
  "type": "object"
}

Exemplo documental

Exemplo de documentação para list_email_folders. 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.

{}