Microsoft Users
Arcade toolkit · docs.arcade.dev
The Microsoft Users toolkit connects Arcade to the Microsoft Graph API, enabling LLMs to read user profiles and navigate organizational hierarchies within a Microsoft 365 tenant.
Capabilities
- Profile lookup — Resolve one or more users by email, UPN, or object ID; automatically batches Graph API calls; enriches results with job title, department, and org data.
- Current user identity — Retrieve the authenticated user's own name, email, job title, department, office location, and tenant domain.
- Org hierarchy traversal — Fetch a user's direct reports (paginated list of users and org contacts) or their direct manager; gracefully handles top-level executives with no manager.
- Work/school accounts only — All tools require a Microsoft 365 work or school account; personal accounts (outlook.com, hotmail.com, live.com) are not supported.
Tools4
MicrosoftUsers_GetDirectReports
Get a user's direct reports from the organizational hierarchy. Returns a paginated list of users and organizational contacts who report directly to the specified user. Requires a Microsoft 365 work or school account. Not available for personal Microsoft accounts (outlook.com, hotmail.com, live.com).
MicrosoftUsers_GetUserManager
Get a user's direct manager from the organizational hierarchy. Returns the manager's profile data. If the user has no manager (e.g., top-level executives), returns a response indicating no manager was found. Requires a Microsoft 365 work or school account. Not available for personal Microsoft accounts (outlook.com, hotmail.com, live.com).
MicrosoftUsers_GetUserProfile
Look up one or more users by email address, UPN, or user ID. Accepts a list of identifiers and automatically optimizes between single and batch Graph API calls. Use this to enrich calendar attendees or email participants with job titles, departments, and org data. Requires a Microsoft 365 work or school account. Not available for personal Microsoft accounts (outlook.com, hotmail.com, live.com).
MicrosoftUsers_WhoAmI
Get information about the current user including name, email, job title, department, office location, and tenant domain.