Microsoft Users

Microsoft Users Toolkit

The Microsoft Users toolkit connects to the Microsoft Graph API to read user profiles and navigate organizational hierarchy for Microsoft 365 work and school accounts. It enables LLM agents to enrich people-related data — attendees, senders, reports — with structured org chart and profile information.

Capabilities

• Profile lookup: Resolve one or more users by email, UPN, or user ID into structured profile data (name, job title, department, office location, tenant domain); automatically optimizes single vs. batch Graph API calls.
• Current user identity: Retrieve the authenticated user's own profile including contact details and organizational metadata.
• Org hierarchy traversal: Walk up or down the reporting chain — fetch a user's direct manager or their full list of direct reports, including organizational contacts.
• Pagination support: Direct-reports responses are paginated, suitable for large teams.

Note: All tools require a Microsoft 365 work or school account. Personal Microsoft accounts (outlook.com, hotmail.com, live.com) are not supported.

OAuth

This toolkit uses OAuth 2.0 via the Microsoft auth provider. See the Arcade Microsoft provider docs for configuration details, including required scopes and tenant setup.