Okta MCP Server Pjo

🚀 Okta Management Console Process Server

An Okta API management console process server that enables Claude to interact with Okta organizations.

🔍 Demo

🛠️ Tools

1. okta_list_users_make_request

• Function: Lists users in an Okta organization.
• Optional Inputs:
  • limit (Number, default: 20): Maximum number of users to return.
  • query (String): Searches for users by firstName, lastName, or email.
• Return: A list of users with basic information.

2. okta_create_user_make_request

• Function: Creates a new user in Okta.
• Required Inputs:
  • profile (Object):
    • firstName (String): The user's first name.
    • lastName (String): The user's last name.
    • email (String): The user's email address.
    • login (String): The user's login name (usually the email).
• Optional Inputs:
  • credentials (Object):
    • password (Object):
      • value (String): The user's password.
• Return: A created user object with all detailed information.

3. okta_get_user_make_request

• Function: Retrieves detailed information about a specific user.
• Required Inputs:
  • userId (String): The user ID or login name.
• Return: A complete user object with all detailed information.

4. okta_update_user_make_request

• Function: Updates the profile of an existing user.
• Required Inputs:
  • userId (String): The ID of the user to update.
  • profile (Object): The profile fields to update.
    • firstName (String, optional)
    • lastName (String, optional)
    • email (String, optional)
    • login (String, optional)
• Return: The updated user information.

5. okta_list_groups_make_request

• Function: Lists all groups in an Okta organization.
• Optional Inputs:
  • filter (String): Filters by group name or ID.
• Return: A list of groups.

6. okta_add_user_to_group_make_request

• Function: Adds a user to a group.
• Required Inputs:
  • userId (String): The user's ID.
  • groupId (String): The group's ID.
• Return: A confirmation message indicating that the user has been successfully added to the group.

⚙️ Setup

💬 Example Interaction with Claude

Here are some ways to naturally use this server with Claude:

1. Search for a user by name

Are there any users named "Zhang San" in my Okta organization?

2. Assign a user to an application

Add user Li Si to the Slack application.

🖥️ Usage with Claude Desktop

Add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "okta": {
      "command": "npx",
      "args": [
        "-y",
        "@yiyang.1i/okta-mcp-server"
      ],
      "env": {
        "OKTA_DOMAIN": "your-domain.okta.com",  // Replace with your Okta domain
        "API_TOKEN": "your-api-token"           // Replace with your API token
      }
    }
  }
}

🚧 Troubleshooting

If you encounter permission errors, verify the following:

1. Whether your API token is valid.
2. Whether your API token has sufficient permissions to perform the operation.
3. Whether the Okta domain name is correctly specified.

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License.