Microsoft Users
Arcade Optimized
Arcade.dev LLM tools for Microsoft Graph user profiles and organizational hierarchy
4tools
Microsoft Users Toolkit
The Microsoft Users toolkit connects to the Microsoft Graph API to expose user profile and organizational hierarchy data for Microsoft 365 work and school accounts. It enables LLM agents to look up users, resolve reporting relationships, and enrich context with org data.
Capabilities
- Self-identity lookup: Retrieve the authenticated user's own profile, including name, email, job title, department, office location, and tenant domain.
- User profile resolution: Look up one or more users by email address, UPN, or user ID; automatically optimizes single vs. batch Graph API calls to enrich calendar attendees or email participants with org metadata.
- Organizational hierarchy traversal: Fetch a user's direct reports (paginated) or their direct manager; handles top-level users with no manager gracefully.
- M365 accounts only: All tools require a Microsoft 365 work or school account — personal accounts (outlook.com, hotmail.com, live.com) are not supported.
OAuth
Authentication is handled via OAuth 2.0 through Arcade's Microsoft provider. See the Arcade Microsoft auth provider docs for configuration details.
Available tools(4)
4 of 4 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
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). | |||
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). | |||
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). | |||
Get information about the current user including name, email, job title,
department, office location, and tenant domain. |
Get Building
Last updated on