m365_create_email_folder

Microsoft 365 · macOS · Windows

Effect: write (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 a new mail folder in their Microsoft 365 / Outlook account: it is created on the Exchange server, so Outlook shows it on every device. name is the new folder's name; parent (optional) puts it inside an existing folder — an id, name or path from m365_list_email_folders, or inbox. If a folder with that name (in any case) already exists under the same parent, nothing is created and the answer is exists=true with its id. Shows a preview first — set confirm=true to create. Answers created=true only after Microsoft 365 returns the new folder on a second read. Needs the Microsoft 365 permission Mail.ReadWrite: an account connected before it was asked for answers consent_required until it is connected again. For a folder of an account in the Mac's Mail app, use create_email_folder.

Required inputs

name — The new folder's name: one line, without /, at most 255 characters.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

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"
    },
    "confirm": {
      "description": "Set to true to create the folder (default: shows a preview only).",
      "type": "boolean"
    },
    "name": {
      "description": "The new folder's name: one line, without /, at most 255 characters.",
      "type": "string"
    },
    "parent": {
      "description": "Folder to create it in: an id, name or path from m365_list_email_folders, or inbox. Leave it out for a top-level folder.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "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.

{
  "confirm": false,
  "name": "Launch 2026",
  "parent": "inbox"
}

Windows

Purpose

Use this when the user wants a new mail folder in their Microsoft 365 / Outlook account: it is created on the Exchange server, so Outlook shows it on every device. name is the new folder's name; parent (optional) puts it inside an existing folder — an id, name or path from m365_list_email_folders, or inbox. If a folder with that name (in any case) already exists under the same parent, nothing is created and the answer is exists=true with its id. Shows a preview first — set confirm=true to create. Answers created=true only after Microsoft 365 returns the new folder on a second read. Needs the Microsoft 365 permission Mail.ReadWrite: an account connected before it was asked for answers consent_required until it is connected again. For a folder in the classic Outlook app on this PC, use outlook_create_folder.

Required inputs

name — The new folder's name: one line, without /, at most 255 characters.

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

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"
    },
    "confirm": {
      "description": "Set to true to create the folder (default: shows a preview only).",
      "type": "boolean"
    },
    "name": {
      "description": "The new folder's name: one line, without /, at most 255 characters.",
      "type": "string"
    },
    "parent": {
      "description": "Folder to create it in: an id, name or path from m365_list_email_folders, or inbox. Leave it out for a top-level folder.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "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.

{
  "confirm": false,
  "name": "Launch 2026",
  "parent": "inbox"
}