scim-sim — SCIM Directory Simulator

A CLI for creating and managing users and groups against any SCIM-compliant Client. Can be Used to Simulate An IDP Like OKTA, Microsoft, OneIdentity, Jumpcloud etc

Installation

Recommended — using uv:

uv tool install scim-sim

First-time setup: If scim-sim is not found after installing, run uv tool update-shell and restart your terminal. This is a one-time step that adds ~/.local/bin to your PATH.

Alternatively, with pip:

pip install scim-sim

Configuration

Before using the tool, run setup to configure your SCIM endpoint:

scim-sim setup

This will prompt you for:

• SCIM Base URL — the endpoint of your SCIM service (e.g. https://api.example.com/scim/v2)
• SCIM Auth Token — your authentication token

Configuration is stored in ~/.scim_config.json. View it anytime with:

scim-sim config

Commands

All commands follow the pattern scim-sim <command> [args]. Run scim-sim --help or scim-sim <command> --help for details.

User Management

# Add a new user (generates random user data)
scim-sim add-user

# Remove a user
scim-sim remove-user <user-id>

Group Management

# Create a new group
scim-sim create-group "Engineering Team"

# Delete a group and permanently delete all its members
scim-sim delete-group <group-id>

# Add a user to a group
scim-sim add-to-group <user-id> <group-id>

# Remove a user from a group
scim-sim remove-from-group <user-id> <group-id>

Warning: delete-group permanently deletes all users that belong to the group, not just the group itself.

Directory Visualization

scim-sim show

Displays a tree view of your full directory structure — groups, members, and ungrouped users.

📂 Directory
├── 👥 Groups
│   ├── Engineering Team │ ID: dirgroup_1234567890123456
│   │    ├── 👤 avinash.kamath@example.com │ ID: diruser_8913202356420102
│   │    └── 👤 srini.k@example.com        │ ID: diruser_4123456789012345
│   │
│   └── Product Team │ ID: dirgroup_6789012345678901
└── 👤 Ungrouped Users
    └── ravi@example.com │ ID: diruser_6789012345678901

Command Reference