Skip to content
All tools

disconnect_m365_account

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

Disconnects ONE Microsoft 365 account and removes its stored sign-in. Pass account (its email, id or display name); with only one account connected it can be omitted, with several it must be given. The first call returns a preview naming the account and how many others stay connected, and changes nothing; confirm=true disconnects. If it was the default account, the oldest remaining one becomes the default and the answer says which. Reconnecting requires the Microsoft sign-in flow again.

Required inputs

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

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.

Full input schema — macOS
{
  "properties": {
    "account": {
      "description": "The account to disconnect: its email (upn), id, or display name. Required when more than one account is connected.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to disconnect. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    }
  },
  "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.

{
  "confirm": false
}

Windows

Purpose

Disconnects ONE Microsoft 365 account and removes its stored sign-in. Pass account (its email, id or display name); with only one account connected it can be omitted, with several it must be given. The first call returns a preview naming the account and how many others stay connected, and changes nothing; confirm=true disconnects. If it was the default account, the oldest remaining one becomes the default and the answer says which. Reconnecting requires the Microsoft sign-in flow again. Only runs on the computer itself, not through the cloud connector.

Required inputs

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

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.

Full input schema — Windows
{
  "properties": {
    "account": {
      "description": "The account to disconnect: its email (upn), id, or display name. Required when more than one account is connected.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to disconnect. Without it the call returns a preview and changes nothing.",
      "type": "boolean"
    }
  },
  "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.

{
  "confirm": false
}