Microsoft Users

Microsoft Users Toolkit

The Microsoft Users toolkit connects to the Microsoft Graph API to expose user profile and organizational hierarchy data from Microsoft 365 tenants. It enables LLMs to look up user profiles, resolve reporting relationships, and identify the authenticated user's own identity.

Capabilities

• Profile lookup: Resolve one or more users by email address, UPN, or user ID; returns job title, department, and org metadata. Optimizes single vs. batch Graph API calls automatically.
• Organizational hierarchy: Retrieve a user's direct reports (paginated) or their direct manager; handles edge cases such as top-level executives with no manager.
• Self-identity: Return the authenticated user's own profile including name, email, job title, department, office location, and tenant domain.
• Microsoft 365 only: All tools require a 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 auth provider docs for configuration details, including required permissions and how to register an app in Azure Active Directory.