sharepoint_list_sites

Windows

Purpose

Lists the SharePoint sites the connected Microsoft 365 work or school account can open: {"sites": [each site's id, name and web address]}. Pass a site's id to sharepoint_list_files. Not available for personal Microsoft accounts.

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.

• 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.

{
  "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"
    },
    "max_results": {
      "description": "At most this many sites (default 50)",
      "maximum": 500,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Words in the site's name; omit to list every site",
      "type": "string"
    }
  },
  "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.

{
  "max_results": 10,
  "query": "Marketing"
}