Keycloak Admin

stdio

Administer Keycloak via its Admin REST API: users, roles, clients, groups, IdP, events.

Getting Started

npx @getmcp/cli add io.github.mrz1880/mcp-keycloak-admin

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

KEYCLOAK_BASE_URL
Base URL of the Keycloak server (no trailing slash).
KEYCLOAK_REALM
Realm the server operates on.
AUTH_MODE
Authentication mode: service_account or password.

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.mrz1880/mcp-keycloak-admin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-keycloak-admin"
      ],
      "env": {
        "KEYCLOAK_BASE_URL": "",
        "KEYCLOAK_REALM": "",
        "AUTH_MODE": "",
        "KC_CLIENT_ID": "",
        "KC_CLIENT_SECRET": "",
        "KC_ADMIN_USERNAME": "",
        "KC_ADMIN_PASSWORD": "",
        "KC_ADMIN_REALM": "",
        "READ_ONLY": "",
        "ALLOWED_REALMS": ""
      }
    }
  }
}

Claude Desktop MCP documentation