Keycloak MCP Server

Source

MCP server implementation for Keycloak user management. Enables AI-powered administration of Keycloak users and realms through the Model Context Protocol (MCP). Seamlessly integrates with Claude Desktop and other MCP clients for automated user operations.

Catalog onlyCatalog onlySTDIO

Overview

Keycloak MCP Server is an implementation of the Model Context Protocol (MCP) for managing Keycloak users and realms, enabling AI-powered administration.

To use the Keycloak MCP Server, install it via NPM or Smithery, configure it with your Keycloak instance, and utilize the provided tools for user management.

Create and delete users in specific realms - List available realms and users in those realms - Seamless integration with Claude Desktop and other MCP clients

Automating user management tasks in Keycloak
Integrating AI tools for enhanced user administration
Managing multiple realms efficiently

Add to your AI client

Use these steps to connect Keycloak MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "keycloak-model-context-protocol-christophenglisch": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-keycloak-model-context-protocol-christophenglisch"
      ]
    }
  }
}

FAQ

Can I use Keycloak MCP Server with any Keycloak version?

Yes, as long as the Keycloak instance is compatible with the Model Context Protocol.

Is there a graphical interface for managing users?

The server is primarily command-line based, but it integrates with tools like Claude Desktop for a more user-friendly experience.

How do I report issues or contribute to the project?

You can report issues or contribute by visiting the project's GitHub repository.

Developer tools