Keycloak MCP Server
A Model Context Protocol server for Keycloak administration, providing tools to manage users and realms.
Features
- Create new users in specific realms
- Delete users from realms
- List available realms
- List users in specific realms
Installation
Installing via Smithery
To install Keycloak for Claude Desktop automatically via Smithery:
Via NPM (Recommended)
The server is available as an NPM package:
Local Development Setup
If you want to develop or modify the server:
Configuration
Using NPM Package (Recommended)
Configure the server in your Claude Desktop configuration file:
For Local Development
Available Tools
create-user
Creates a new user in a specified realm.
Inputs:
realm: The realm name
username: Username for the new user
email: Email address for the user
firstName: User's first name
lastName: User's last name
delete-user
Deletes a user from a specified realm.
Inputs:
realm: The realm name
userId: The ID of the user to delete
list-realms
Lists all available realms.
list-users
Lists all users in a specified realm.
Inputs:
realm: The realm name
Development
Testing
To test the server using MCP Inspector:
Deployment
NPM Package
This project is automatically published to NPM via GitHub Actions when a new release is published on GitHub.
Setup Requirements for Deployment
- Create NPM account and get access token
- Add NPM_TOKEN secret to GitHub repository
Prerequisites
- Node.js 18 or higher
- Running Keycloak instance
Keycloak MCP Server
A Model Context Protocol server for Keycloak administration, providing tools to manage users and realms.
Features
- Create new users in specific realms
- Delete users from realms
- List available realms
- List users in specific realms
Installation
Installing via Smithery
To install Keycloak for Claude Desktop automatically via Smithery:
Via NPM (Recommended)
The server is available as an NPM package:
Local Development Setup
If you want to develop or modify the server:
Configuration
Using NPM Package (Recommended)
Configure the server in your Claude Desktop configuration file:
For Local Development
Available Tools
create-user
Creates a new user in a specified realm.
Inputs:
realm: The realm name
username: Username for the new user
email: Email address for the user
firstName: User's first name
lastName: User's last name
delete-user
Deletes a user from a specified realm.
Inputs:
realm: The realm name
userId: The ID of the user to delete
list-realms
Lists all available realms.
list-users
Lists all users in a specified realm.
Inputs:
realm: The realm name
Development
Testing
To test the server using MCP Inspector:
Deployment
NPM Package
This project is automatically published to NPM via GitHub Actions when a new release is published on GitHub.
Setup Requirements for Deployment
- Create NPM account and get access token
- Add NPM_TOKEN secret to GitHub repository
Prerequisites
- Node.js 18 or higher
- Running Keycloak instance