list_email_folders

macOS

Finalidade

Lista a árvore completa de pastas (caixas de correio) das contas do Apple Mail (Mail.app), incluindo subpastas aninhadas. Use-a para descobrir os nomes exatos de pasta que move_email(target_mailbox=...) e list_emails(mailbox=...) esperam. Contas Outlook.com, Exchange, Gmail, iCloud e IMAP adicionadas ao Mail.app estão todas incluídas. Para uma caixa do Microsoft 365 somente via Graph e não adicionada ao Mail.app, use m365_list_emails. Passe account=<name> (de list_email_accounts) para enumerar uma conta por completo; sem isso, todas as contas são percorridas, o que pode ser lento no macOS 15+. As contagens de mensagens vêm desativadas por padrão (lento no IMAP); passe include_counts=true para adicionar não lidas/total por pasta (do índice local do Mail quando uma conta nomeada é resolvida a partir do disco, ou da contagem ao vivo do próprio Mail.app caso contrário; em ambos os casos veja unread_count_note na resposta).

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": {
      "description": "Mail.app account whose folder tree to list (from list_email_accounts). Defaults to every account.",
      "type": "string"
    },
    "include_counts": {
      "default": "false",
      "description": "Include the message count of each folder. Slower, because each folder has to be counted.",
      "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.

{}