License

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

YiyangLi / okta-mcp-server Public

• Notifications
  You must be signed in to change notification settings

• Fork 0

• Star 4

License

MIT license

4 stars
0 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

YiyangLi/okta-mcp-server

main

Branches
Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

4 Commits

| | |
| assets | | assets | | |
| build | | build | | |
| src | | src | | |
| .gitignore | | .gitignore | | |
| LICENSE | | LICENSE | | |
| README.md | | README.md | | |
| how-do-i-prompt.md | | how-do-i-prompt.md | | |
| package-lock.json | | package-lock.json | | |
| package.json | | package.json | | |
| tsconfig.json | | tsconfig.json | | |
| View all files | | |

Repository files navigation

Okta MCP Server

MCP Server for the Okta API, enabling Claude to interact with Okta organizations.

Demo

Tools

1. okta_list_users_make_request

   • List users in the Okta organization
   • Optional inputs:
     • limit (number, default: 20): Maximum number of users to return
     • query (string): Search a user by firstName, lastName, or email
   • Returns: List of users with their basic information

   • okta_create_user_make_request

   • Create a new user in Okta

   • Required inputs:
     • profile (object):
       • firstName (string): User's first name
       • lastName (string): User's last name
       • email (string): User's email address
       • login (string): User's login (usually email)
   • Optional inputs:
     • credentials (object):
       • password (object):
         • value (string): User's password
   • Returns: Created user object with full details

   • okta_get_user_make_request

   • Get detailed information about a specific user

   • Required inputs:
     • userId (string): User ID or login
   • Returns: Full user object with all details

   • okta_update_user_make_request

   • Update an existing user's profile

   • Required inputs:
     • userId (string): User ID to update
     • profile (object): Profile fields to update
       • firstName (string, optional)
       • lastName (string, optional)
       • email (string, optional)
       • login (string, optional)
   • Returns: Updated user object

   • okta_delete_user_make_request

   • Delete a user (automatically handles deactivation first)

   • Required inputs:
     • userId (string): User ID to delete
   • Returns: Confirmation message

   • okta_list_groups_make_request

   • List groups in the Okta organization

   • Optional inputs:
     • limit (number, default: 20): Maximum number of groups to return
     • search (string): Search expression for groups
   • Returns: List of groups with their information

   • okta_create_group_make_request

   • Create a new group

   • Required inputs:
     • profile (object):
       • name (string): Name of the group
       • description (string, optional): Group description
   • Returns: Created group object

   • okta_assign_user_to_group_make_request

   • Add a user to a group

   • Required inputs:
     • groupId (string): ID of the group
     • userId (string): ID of the user
   • Returns: Confirmation message

   • okta_list_applications_make_request

   • List applications in the Okta organization

   • Optional inputs:
     • limit (number, default: 20): Maximum number of applications to return
     • query (string): Search for apps with name or label properties
   • Returns: List of applications with their details

   • okta_assign_user_to_application_make_request

   • Assign a user to an application

   • Required inputs:
     • appId (string): Application ID
     • userId (string): User ID
   • Optional inputs:
     • profile (object): Application-specific user profile
   • Returns: Application user assignment object

   • okta_assign_group_to_application_make_request

   • Assign a group to an application

   • Required inputs:
     • appId (string): Application ID
     • groupId (string): Group ID
   • Returns: Application group assignment object

   • okta_deactivate_application_make_request

   • Deactivate an application

   • Required inputs:
     • appId (string): ID of the application to deactivate
   • Returns: Confirmation message

   • okta_delete_application_make_request

   • Delete an application

   • Required inputs:
     • appId (string): ID of the application to delete
   • Returns: Confirmation message

Setup

1. Create an Okta API Token:

   • Log in to your Okta organization as an administrator
   • Navigate to Security → API → Tokens
   • Click "Create Token" and save the token value

   • Get your Okta Domain:

   • Your Okta domain typically looks like: dev-123456.okta.com

   • You can find this in your Okta dashboard URL

Example Interactions with Claude

Here are some natural ways to interact with the server through Claude:

1. Find a user by name

   Is there a user named "Joe" in my okta org?

2. Assign a user to an application

   assign the user [email protected] to the Slack application

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

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

Troubleshooting

If you encounter permission errors, verify that:

1. Your API token is valid
2. The API token has sufficient permissions for the operations you're trying to perform
3. The Okta domain is correctly specified

License

This MCP server is licensed 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.

About

No description, website, or topics provided.

Resources

Readme

License

MIT license

Activity

Stars

4 stars

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• JavaScript 100.0%

You can’t perform that action at this time.