Skip to main content
Server path: /microsoft-active-directory | Type: Application | PCID required: Yes Users, groups, and directory management

Tools

ToolDescription
microsoft-active-directory_list_usersList users in Microsoft Active Directory with optional pagination support
microsoft-active-directory_get_userGet a specific user by ID from Microsoft Active Directory
microsoft-active-directory_search_user_by_emailSearch for users by email (userPrincipalName) in Microsoft Active Directory
microsoft-active-directory_search_user_by_nameSearch 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_userCreate a new user in Microsoft Active Directory
microsoft-active-directory_update_userUpdate an existing user in Microsoft Active Directory
microsoft-active-directory_list_groupsList all groups in Microsoft Active Directory
microsoft-active-directory_get_groupGet a specific group by ID from Microsoft Active Directory
microsoft-active-directory_search_group_by_nameSearch for groups by display name in Microsoft Active Directory
microsoft-active-directory_create_groupCreate a new group in Microsoft Active Directory
microsoft-active-directory_get_group_membersGet members of a group in Microsoft Active Directory
microsoft-active-directory_add_user_to_groupAdd a user to a group in Microsoft Active Directory
microsoft-active-directory_remove_user_from_groupRemove a user from a group in Microsoft Active Directory
microsoft-active-directory_list_directory_rolesList all directory roles in Microsoft Active Directory
microsoft-active-directory_get_directory_role_membersGet members of a directory role in Microsoft Active Directory
microsoft-active-directory_list_service_principalsList all service principals in Microsoft Active Directory
microsoft-active-directory_get_service_principalGet 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:
ParameterTypeRequiredDefaultDescription
pageSizenumberNoNumber of users to return per page. Must be a positive integer. (default: 20, max: 999)
pageTokenstringNoToken for retrieving the next page of results

microsoft-active-directory_get_user

Get a specific user by ID from Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID to retrieve

microsoft-active-directory_search_user_by_email

Search for users by email (userPrincipalName) in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesEmail 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:
ParameterTypeRequiredDefaultDescription
namestringYesName 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:
ParameterTypeRequiredDefaultDescription
displayNamestringYesDisplay name for the user
userPrincipalNamestringYesUser principal name (email format)
mailNicknamestringYesMail nickname for the user
passwordstringYesInitial password for the user
forceChangePasswordbooleanNotrueForce password change on next sign-in
accountEnabledbooleanNotrueWhether the account is enabled
givenNamestringNoFirst name
surnamestringNoLast name
jobTitlestringNoJob title
departmentstringNoDepartment
officeLocationstringNoOffice location

microsoft-active-directory_update_user

Update an existing user in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
userIdstringYesUser ID to update
displayNamestringNoDisplay name for the user
jobTitlestringNoJob title
departmentstringNoDepartment
officeLocationstringNoOffice location
accountEnabledbooleanNoWhether the account is enabled
givenNamestringNoFirst name
surnamestringNoLast name

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 Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID to retrieve

microsoft-active-directory_search_group_by_name

Search for groups by display name in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesGroup display name to search for

microsoft-active-directory_create_group

Create a new group in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
displayNamestringYesDisplay name for the group
mailNicknamestringYesMail nickname for the group
mailEnabledbooleanNofalseWhether the group is mail-enabled
securityEnabledbooleanNotrueWhether the group is security-enabled
descriptionstringNoDescription of the group
groupTypesstring[]No[]Group types - “Unified” for Microsoft 365 groups, “DynamicMembership” for dynamic groups
visibilitystringNo"Private"Group visibility - Public, Private, or HiddenMembership

microsoft-active-directory_get_group_members

Get members of a group in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID to get members for

microsoft-active-directory_add_user_to_group

Add a user to a group in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID to add the user to
userIdstringYesUser ID to add to the group

microsoft-active-directory_remove_user_from_group

Remove a user from a group in Microsoft Active Directory Parameters:
ParameterTypeRequiredDefaultDescription
groupIdstringYesGroup ID to remove the user from
userIdstringYesUser ID to remove from the group

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 Parameters:
ParameterTypeRequiredDefaultDescription
roleIdstringYesDirectory role ID to get members for

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 Parameters:
ParameterTypeRequiredDefaultDescription
servicePrincipalIdstringYesService principal ID to retrieve