Overview
Keycloak MCP Server is a Model Context Protocol server designed to streamline Keycloak administration by enabling natural language interaction for common management tasks. It exposes four primary tools: create-user, delete-user, list-realms, and list-users. Each tool is documented with inputs: create-user requires realm, username, email, firstName, and lastName; delete-user requires realm and userId; list-realms has no inputs; list-users requires realm. The server can be installed via Smithery or as an NPM package, and supports local development by building from source. Configuration supports Claude Desktop integration by declaring an MCP server named keycloak with a command and environment variables such as KEYCLOAK_URL, KEYCLOAK_ADMIN, and KEYCLOAK_ADMIN_PASSWORD. For local development, you can run node path/to/dist/index.js with the same environment variables. Prerequisites include Node.js 18+ and a running Keycloak instance. The README provides testing steps using MCP Inspector, development workflow (npm run watch), and deployment steps to publish on NPM via GitHub Actions. The server aims to make Keycloak administration accessible through natural language interfaces, lowering the barrier for non-technical users to manage realms and users.
Features
Create new users in specific realms
Creates a new user in a specified Keycloak realm.
Delete users from realms
Deletes a user from a specified realm using the user ID.
List available realms
Lists all realms available in the Keycloak instance.
List users in specific realms
Lists all users in a specified realm.
Who Is This For?
- Keycloak Admins:Admins managing Keycloak users and realms through natural language interactions.




