remove_user_from_group
Remove a user from a group in Keycloak identity management by specifying user ID, group ID, and optional realm.
Instructions
Remove a user from a group.
Args:
user_id: User ID
group_id: Group ID
realm: Target realm (uses default if not specified)
Returns:
Status messageInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | ||
| group_id | Yes | ||
| realm | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/tools/group_tools.py:191-212 (handler)The handler function decorated with @mcp.tool(), which registers the tool and defines the input schema via type hints. It removes the user from the group by making a DELETE request to Keycloak API.
@mcp.tool() async def remove_user_from_group( user_id: str, group_id: str, realm: Optional[str] = None ) -> Dict[str, str]: """ Remove a user from a group. Args: user_id: User ID group_id: Group ID realm: Target realm (uses default if not specified) Returns: Status message """ await client._make_request( "DELETE", f"/users/{user_id}/groups/{group_id}", realm=realm ) return { "status": "removed", "message": f"User {user_id} removed from group {group_id}", }