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 から）を渡すと 1 つのアカウントを完全に列挙します。省略するとすべてのアカウントを走査するため、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 のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{}