Is io.github.shigechika/keycloak-mcp safe to use?

io.github.shigechika/keycloak-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.shigechika/keycloak-mcp?

io.github.shigechika/keycloak-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.shigechika/keycloak-mcp do?

io.github.shigechika/keycloak-mcp provides 21 tools: count_users, search_users, get_user, reset_password, reset_passwords_batch and 16 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.shigechika/keycloak-mcp?

io.github.shigechika/keycloak-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.

Is io.github.shigechika/keycloak-mcp actively maintained?

io.github.shigechika/keycloak-mcp is actively maintained — last commit was 3 days ago.

io.github.shigechika/keycloak-mcp

keycloak-mcp

MCP server for KeyCloak Admin REST API via Service Account

21 tools GitHub PyPI

No known CVEs

No license

Actively maintained

Last commit 3d ago

Works with most clients

Transport: stdio

21 tools · ~902 tok

Grade B · 0.5% of 200K ctx

Edit this pageView history

Security DevOps

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "keycloak-mcp": {
      "env": {
        "KEYCLOAK_URL": "https://sso.example.com",
        "KEYCLOAK_CLIENT_ID": "keycloak-mcp",
        "KEYCLOAK_CLIENT_SECRET": ""
      },
      "type": "stdio",
      "command": "keycloak-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shigechika-keycloak-mcp)](https://mcppedia.org/s/io-github-shigechika-keycloak-mcp)

Read me

What io.github.shigechika/keycloak-mcp does

MCP (Model Context Protocol) server for KeyCloak Admin REST API.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'keycloak-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked keycloak-mcp against OSV.dev.

Inventory

Tools (21)

Click any tool to inspect its schema.

~902 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.shigechika/keycloak-mcp safe to use?: io.github.shigechika/keycloak-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.shigechika/keycloak-mcp?: io.github.shigechika/keycloak-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.shigechika/keycloak-mcp do?: io.github.shigechika/keycloak-mcp provides 21 tools: count_users, search_users, get_user, reset_password, reset_passwords_batch and 16 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.shigechika/keycloak-mcp?: io.github.shigechika/keycloak-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.shigechika/keycloak-mcp actively maintained?: io.github.shigechika/keycloak-mcp is actively maintained — last commit was 3 days ago.

Similar servers

Others in security / devops

View all →

Mcp Gitlab96

MCP server for using the GitLab API

1.6k 12

Evil Mcp Server93

An evil MCP server used for redteam testing

30 1

io.github.jasonxkensei/xproof92

Proof primitive for AI agents on MultiversX. Anchor file hashes on-chain as verifiable proofs.

1 1

Mcp Gitlab Server92

Enhanced MCP server for GitLab: group projects listing and activity tracking

51 2

MCP Security Weekly

Get CVE alerts and security updates for io.github.shigechika/keycloak-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Security DevOps

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "keycloak-mcp": {
      "env": {
        "KEYCLOAK_URL": "https://sso.example.com",
        "KEYCLOAK_CLIENT_ID": "keycloak-mcp",
        "KEYCLOAK_CLIENT_SECRET": ""
      },
      "type": "stdio",
      "command": "keycloak-mcp"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shigechika-keycloak-mcp)](https://mcppedia.org/s/io-github-shigechika-keycloak-mcp)

Read me

What io.github.shigechika/keycloak-mcp does

MCP (Model Context Protocol) server for KeyCloak Admin REST API.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'keycloak-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

keycloak-mcp

English | 日本語

An MCP (Model Context Protocol) server for the KeyCloak Admin REST API.

Authenticates via a Service Account (Client Credentials Grant), so no human password or TOTP is involved. Also Infinispan-safe — it never creates user sessions and never hits the userinfo endpoint.

Features

Users

Tool	Description
`count_users`	Total user count in the realm
`search_users`	Partial-match search (username / email / name)
`get_user`	Full detail for an exact username
`reset_password`	Reset one user's password
`reset_passwords_batch`	Bulk reset from CSV (`username,password` per line; blank password is generated)
`get_user_sessions`	Active sessions for one user, timestamps in local time
`logout_user`	Kill all active sessions for one user

Groups

Tool	Description
`list_user_groups`	Which groups a user belongs to
`list_users_by_group`	Members of a group

Security

Tool	Description
`get_brute_force_status`	Whether a user is currently locked by brute-force detection
`get_login_failures_by_ip`	Failure breakdown by source IP (site-labeled when `KEYCLOAK_SITES_INI` is set)
`detect_login_loops`	Flag users who logged in too many times in a short window (redirect loops)

Events

Tool	Description
`get_events`	Filter by type, username, client, IP, and date range. Username is resolved to user ID internally. Failure events include KeyCloak's `error` field (e.g. `invalid_user_credentials`).
`get_login_stats`	Login success/failure totals, paginated across all results
`get_login_stats_by_hour`	Logins bucketed by hour of day (local time)
`get_login_stats_by_client`	Logins bucketed by client / SP
`get_password_update_events`	`UPDATE_PASSWORD` history

Admin Events

get_events only sees user events. Actions driven by an admin — or by a service account writing custom attributes — don't show up there. The admin-event endpoint fills that gap.

Tool	Description
`get_admin_events`	Filter by operation (CREATE / UPDATE / DELETE / ACTION), resource type (USER / CLIENT / ROLE / GROUP / …), resource path, and date range
`get_user_attribute_history`	UPDATE/ACTION events scoped to one user — handy for tracking when a custom attribute (e.g. `temp_password`) was written by an automated pipeline

Both tools accept max_repr to control the representation payload: positive = truncate to N chars (default 500), 0 = omit, negative = include in full.

Sessions & Clients

Tool	Description
`get_session_stats`	Active session count per client
`get_client_sessions`	Active sessions for one client (SP)
`list_clients`	SAML and OIDC clients in the realm
`get_realm_roles`	Realm-level roles

Morning Patrol

Tool	Description
`daily_brief`	One-shot morning health check: login stats, brute-force IPs, active sessions, password updates, and admin events in a single Markdown summary. IPs exceeding `ip_failure_threshold` failures (default 50) are flagged WARNING; API errors surface as CRITICAL. `since_hours` controls the look-back window (default 18 h).

Setup

# uv
uv pip install keycloak-mcp

# pip
pip install keycloak-mcp

From source:

git clone https://github.com/shigechika/keycloak-mcp.git
cd keycloak-mcp

# uv
uv sync

# pip
pip install -e .

Configuration

Variable	Description	Default
`KEYCLOAK_URL`	Base URL, e.g. `https://keycloak.example.com`	required
`KEYCLOAK_REALM`	Realm name	`master`
`KEYCLOAK_CLIENT_ID`	Service Account client ID	required
`KEYCLOAK_CLIENT_SECRET`	Client secret	*require

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked keycloak-mcp against OSV.dev.

Inventory

Tools (21)

Click any tool to inspect its schema.

~902 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.shigechika/keycloak-mcp safe to use?: io.github.shigechika/keycloak-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.shigechika/keycloak-mcp?: io.github.shigechika/keycloak-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.shigechika/keycloak-mcp do?: io.github.shigechika/keycloak-mcp provides 21 tools: count_users, search_users, get_user, reset_password, reset_passwords_batch and 16 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.shigechika/keycloak-mcp?: io.github.shigechika/keycloak-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio transport.
Is io.github.shigechika/keycloak-mcp actively maintained?: io.github.shigechika/keycloak-mcp is actively maintained — last commit was 3 days ago.