Active Directory

v1.0.0Cloud Servicesstable

MCP server for Active Directory user management with PowerShell backend

mcp-active-directorymcpai-integration
Share:
14
Stars
0
Downloads
0
Weekly
0/5

What is Active Directory?

Active Directory is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for active directory user management with powershell backend

MCP server for Active Directory user management with PowerShell backend

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for Active Directory user management with PowerSh

Use Cases

Manage Active Directory users with PowerShell backend.
Automate user management through MCP interface.
rosingul

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedDec 18, 2025
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-active-directory

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Active Directory

The MCP Active Directory Server enables AI agents to manage Windows Active Directory users and domain infrastructure through a Python MCP server that delegates operations to a PowerShell backend. It provides 14 tools covering user creation and modification, group membership management, domain and forest information retrieval, password policy queries, replication status checks, and site topology inspection. IT administrators can use Claude to automate routine AD tasks — creating new employee accounts, adding users to security groups, or auditing domain configuration — through natural language rather than scripting directly.

Prerequisites

  • Windows environment with Active Directory domain access (the PowerShell backend requires Windows)
  • Python 3 installed on the machine running the MCP server
  • Windows Credential Manager configured with AD service account credentials under the target name 'MCPActiveDirectory'
  • A service account in Active Directory with the minimum permissions needed for the intended operations
  • An MCP-compatible client such as Claude Desktop
1

Clone the repository

Download the mcp-active-directory-server source code to your Windows machine.

git clone https://github.com/rosingul/mcp-active-directory-server.git
cd mcp-active-directory-server
2

Install Python dependencies

Install the required Python packages for the MCP server layer.

pip install -r requirements.txt
3

Store Active Directory credentials in Windows Credential Manager

The server reads AD credentials from Windows Credential Manager under the target name 'MCPActiveDirectory'. Add your service account credentials using the Windows Credential Manager UI or via PowerShell.

# PowerShell (run as Administrator):
cmdkey /add:MCPActiveDirectory /user:DOMAIN\serviceaccount /pass:YourPassword
4

Review and adjust PowerShell configuration

Open the PowerShell backend script and set the target organizational unit, domain name, and default password for new users to match your environment.

# In the PowerShell script, configure:
$TargetOU = "OU=ManagedUsers,DC=yourdomain,DC=local"
$DomainName = "yourdomain.local"
$DefaultPassword = "TempPassword123!"
5

Configure Claude Desktop

Add the MCP server to your Claude Desktop configuration with the path to the Python server entry point.

{
  "mcpServers": {
    "active-directory": {
      "command": "python",
      "args": ["C:\\path\\to\\mcp-active-directory-server\\server.py"]
    }
  }
}

Active Directory Examples

Client configuration

Claude Desktop configuration for the Active Directory MCP server on Windows.

{
  "mcpServers": {
    "active-directory": {
      "command": "python",
      "args": ["C:\\Users\\admin\\mcp-active-directory-server\\server.py"]
    }
  }
}

Prompts to try

Example prompts for Active Directory user and domain management tasks.

- "Create a new Active Directory user for John Smith with username jsmith in the ManagedUsers OU."
- "Add the user jsmith to the 'VPN Users' security group."
- "Get the full user information for [email protected]."
- "What is the domain password policy for yourdomain.local?"
- "Check the current AD replication status across all domain controllers."
- "List all sites and services in the Active Directory forest."

Troubleshooting Active Directory

PowerShell script fails with 'Access Denied' or credential errors

Verify the credentials stored in Windows Credential Manager under 'MCPActiveDirectory' are correct and belong to a domain account with sufficient AD permissions. Run 'cmdkey /list' to confirm the entry exists, and test the account by logging in interactively.

Server cannot connect to Active Directory domain

The machine running the MCP server must be joined to the domain or have network connectivity to a domain controller. Test with 'Test-ADConnection' by prompting Claude to run it, or verify with 'nltest /dsgetdc:yourdomain.local' in PowerShell.

User creation fails with 'OU not found' error

Verify that $TargetOU in the PowerShell configuration matches an existing organizational unit. Use 'Get-ADOrganizationalUnit -Filter *' in PowerShell to list all OUs and copy the exact distinguished name.

Frequently Asked Questions about Active Directory

What is Active Directory?

Active Directory is a Model Context Protocol (MCP) server that mcp server for active directory user management with powershell backend It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Active Directory?

Follow the installation instructions on the Active Directory GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Active Directory?

Active Directory works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Active Directory free to use?

Yes, Active Directory is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-active-directory": { "command": "npx", "args": ["-y", "mcp-active-directory"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Active Directory?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides