search_m365_directory

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

Search your organization's Microsoft 365 directory for users by name or email. Returns matching users with their title, department, and contact info.

Required inputs

query — Name or email to search for, e.g. 'Sarah' or 'sarah@contoso.com'

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.

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"
    },
    "limit": {
      "description": "Max results (default 10, max 25)",
      "type": "integer"
    },
    "query": {
      "description": "Name or email to search for, e.g. 'Sarah' or 'sarah@contoso.com'",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "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.

{
  "query": "Alex Rivera"
}

Windows