/microsoft-active-directory | Type: Application | PCID required: Yes
Users, groups, and directory management
Tools
| Tool | Description |
|---|---|
microsoft-active-directory_list_users | List users in Microsoft Active Directory with optional pagination support |
microsoft-active-directory_get_user | Get a specific user by ID from Microsoft Active Directory |
microsoft-active-directory_search_user_by_email | Search for users by email (userPrincipalName) in Microsoft Active Directory |
microsoft-active-directory_search_user_by_name | Search for users by name in Microsoft Active Directory. Performs case-insensitive partial matching across display name, first name (givenName), and last name(surname) fields. |
microsoft-active-directory_create_user | Create a new user in Microsoft Active Directory |
microsoft-active-directory_update_user | Update an existing user in Microsoft Active Directory |
microsoft-active-directory_list_groups | List all groups in Microsoft Active Directory |
microsoft-active-directory_get_group | Get a specific group by ID from Microsoft Active Directory |
microsoft-active-directory_search_group_by_name | Search for groups by display name in Microsoft Active Directory |
microsoft-active-directory_create_group | Create a new group in Microsoft Active Directory |
microsoft-active-directory_get_group_members | Get members of a group in Microsoft Active Directory |
microsoft-active-directory_add_user_to_group | Add a user to a group in Microsoft Active Directory |
microsoft-active-directory_remove_user_from_group | Remove a user from a group in Microsoft Active Directory |
microsoft-active-directory_list_directory_roles | List all directory roles in Microsoft Active Directory |
microsoft-active-directory_get_directory_role_members | Get members of a directory role in Microsoft Active Directory |
microsoft-active-directory_list_service_principals | List all service principals in Microsoft Active Directory |
microsoft-active-directory_get_service_principal | Get a specific service principal by ID from Microsoft Active Directory |
microsoft-active-directory_list_users
List users in Microsoft Active Directory with optional pagination support Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
pageSize | number | No | — | Number of users to return per page. Must be a positive integer. (default: 20, max: 999) |
pageToken | string | No | — | Token for retrieving the next page of results |
microsoft-active-directory_get_user
Get a specific user by ID from Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID to retrieve |
microsoft-active-directory_search_user_by_email
Search for users by email (userPrincipalName) in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | string | Yes | — | Email address to search for |
microsoft-active-directory_search_user_by_name
Search for users by name in Microsoft Active Directory. Performs case-insensitive partial matching across display name, first name (givenName), and last name(surname) fields. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Name to search for (case-insensitive partial match in display name, first name, or last name) |
microsoft-active-directory_create_user
Create a new user in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
displayName | string | Yes | — | Display name for the user |
userPrincipalName | string | Yes | — | User principal name (email format) |
mailNickname | string | Yes | — | Mail nickname for the user |
password | string | Yes | — | Initial password for the user |
forceChangePassword | boolean | No | true | Force password change on next sign-in |
accountEnabled | boolean | No | true | Whether the account is enabled |
givenName | string | No | — | First name |
surname | string | No | — | Last name |
jobTitle | string | No | — | Job title |
department | string | No | — | Department |
officeLocation | string | No | — | Office location |
microsoft-active-directory_update_user
Update an existing user in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
userId | string | Yes | — | User ID to update |
displayName | string | No | — | Display name for the user |
jobTitle | string | No | — | Job title |
department | string | No | — | Department |
officeLocation | string | No | — | Office location |
accountEnabled | boolean | No | — | Whether the account is enabled |
givenName | string | No | — | First name |
surname | string | No | — | Last name |
microsoft-active-directory_list_groups
List all groups in Microsoft Active Directorymicrosoft-active-directory_get_group
Get a specific group by ID from Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID to retrieve |
microsoft-active-directory_search_group_by_name
Search for groups by display name in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | Group display name to search for |
microsoft-active-directory_create_group
Create a new group in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
displayName | string | Yes | — | Display name for the group |
mailNickname | string | Yes | — | Mail nickname for the group |
mailEnabled | boolean | No | false | Whether the group is mail-enabled |
securityEnabled | boolean | No | true | Whether the group is security-enabled |
description | string | No | — | Description of the group |
groupTypes | string[] | No | [] | Group types - “Unified” for Microsoft 365 groups, “DynamicMembership” for dynamic groups |
visibility | string | No | "Private" | Group visibility - Public, Private, or HiddenMembership |
microsoft-active-directory_get_group_members
Get members of a group in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID to get members for |
microsoft-active-directory_add_user_to_group
Add a user to a group in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID to add the user to |
userId | string | Yes | — | User ID to add to the group |
microsoft-active-directory_remove_user_from_group
Remove a user from a group in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
groupId | string | Yes | — | Group ID to remove the user from |
userId | string | Yes | — | User ID to remove from the group |
microsoft-active-directory_list_directory_roles
List all directory roles in Microsoft Active Directorymicrosoft-active-directory_get_directory_role_members
Get members of a directory role in Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
roleId | string | Yes | — | Directory role ID to get members for |
microsoft-active-directory_list_service_principals
List all service principals in Microsoft Active Directorymicrosoft-active-directory_get_service_principal
Get a specific service principal by ID from Microsoft Active Directory Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
servicePrincipalId | string | Yes | — | Service principal ID to retrieve |

