Keycloak MCP

Keycloak MCP

Model Context Protocol server for Keycloak administration, providing tools to manage users and realms.

34
Stars
9
Forks
2
Releases

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.

Details

Owner
ChristophEnglisch
Language
TypeScript
License
Updated
2025-12-07

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.

Audience

Keycloak AdminsAdmins managing Keycloak users and realms through natural language interactions.

Tags

KeycloakMCPModel Context ProtocolusersrealmsadministrationCLINPM