keycloak-mcp-server MCP Server

A comprehensive Model Context Protocol (MCP) server for Keycloak administration, providing 80+ tools to manage users, realms, clients, roles, groups, sessions, events, organizations, protocol…

Local serverstdioMIT

What is the keycloak-mcp-server MCP Server?

keycloak-mcp-server is an MCP project maintained in the m0-ar/keycloak-mcp-server repository. The maintainer describes its purpose as “A comprehensive Model Context Protocol (MCP) server for Keycloak administration, providing 80+ tools to manage users, realms, clients, roles, groups, sessions, events, organizations, protocol mappers…”. Read the project documentation for the complete scope.

Installation

The documented npm package is keycloak-mcp-server. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares KEYCLOAK_URL, KEYCLOAK_ADMIN, KEYCLOAK_ADMIN_PASSWORD. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

How to install the keycloak-mcp-server MCP Server

{
  "mcpServers": {
    "keycloak": {
      "command": "npx",
      "args": [
        "keycloak-mcp-server"
      ],
      "env": {
        "KEYCLOAK_URL": "YOUR_KEYCLOAK_URL",
        "KEYCLOAK_ADMIN": "YOUR_KEYCLOAK_ADMIN",
        "KEYCLOAK_ADMIN_PASSWORD": "YOUR_KEYCLOAK_ADMIN_PASSWORD"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
KEYCLOAK_URLDeclared in the maintainer’s client configuration.Check documentation
KEYCLOAK_ADMINDeclared in the maintainer’s client configuration.Check documentation
KEYCLOAK_ADMIN_PASSWORDDeclared in the maintainer’s client configuration.Check documentation