Skip to content
All tools

m365_list_email_folders

Microsoft 365 · macOS · Windows

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Use this when the user wants the mail folders of their Microsoft 365 / Outlook account as the Exchange server has them: every folder and subfolder with its id, name, path (Parent/Child), parent_id, total and unread counts. A folder's id, name or path goes to m365_list_emails and m365_search_emails (folder), m365_create_email_folder (parent) and m365_move_email (destination). For the folders of an account in the Mac's Mail app, use list_email_folders.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{}

Windows

Purpose

Use this when the user wants the mail folders of their Microsoft 365 / Outlook account as the Exchange server has them: every folder and subfolder with its id, name, path (Parent/Child), parent_id, total and unread counts. A folder's id, name or path goes to m365_list_emails and m365_search_emails (folder), m365_create_email_folder (parent) and m365_move_email (destination). For mail in the classic Outlook app on this PC, use outlook_list_emails.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{}