list_email_folders

macOS

목적

Apple 메일(Mail.app) 계정의 전체 폴더(메일함) 트리를 중첩된 하위 폴더까지 포함해 나열합니다. move_email(target_mailbox=...)과 list_emails(mailbox=...)가 요구하는 정확한 폴더 이름을 찾는 데 사용하세요. Mail.app에 추가된 Outlook.com, Exchange, Gmail, iCloud, IMAP 계정이 모두 포함됩니다. Mail.app에 추가되지 않은 Graph 전용 Microsoft 365 메일함에는 대신 m365_list_emails를 사용하세요. account=<name>(list_email_accounts에서 확인)을 전달하면 한 계정을 완전히 열거하며, 전달하지 않으면 모든 계정을 순회하므로 macOS 15+에서는 느릴 수 있습니다. 메시지 수는 기본적으로 꺼져 있습니다(IMAP에서 느림). include_counts=true를 전달하면 폴더별 읽지 않음/전체 수가 추가됩니다(지정한 계정을 디스크에서 확인할 수 있으면 Mail의 로컬 인덱스에서, 그렇지 않으면 Mail.app 자체의 실시간 수에서 가져옴. 어느 경우든 응답의 unread_count_note 참조).

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

• 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

{
  "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"
}

문서 예시

list_email_folders 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{}