Skip to content

Summary

Okta's official open-source MCP server: manage users, groups, apps, policies and branding in your Okta org from an AI agent, with scope-gated tools and confirmation on destructive actions.

Features

  • Full CRUD over users, groups, applications and policies via Okta's Admin Management APIs
  • Scope-based tool loading — only tools covered by OKTA_SCOPES are registered, cutting token use and enforcing least privilege
  • Destructive operations prompt for confirmation through the MCP Elicitation API, with fallback for clients that lack it
  • Device Assurance Policy tools for reading, configuring and evaluating device posture
  • Customisation tools for brands, themes, custom domains, sign-in pages and email templates
  • Two auth modes: Device Authorization Grant for interactive use, Private Key JWT for server-to-server

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Okta MCP Server" tools will be available.
{
  "mcpServers": {
    "okta-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OKTA_ORG_URL",
        "-e",
        "OKTA_CLIENT_ID",
        "-e",
        "OKTA_SCOPES",
        "-e",
        "OKTA_PRIVATE_KEY",
        "-e",
        "OKTA_KEY_ID",
        "okta-mcp-server"
      ],
      "env": {
        "OKTA_ORG_URL": "https://your-org.okta.com",
        "OKTA_CLIENT_ID": "your-client-id",
        "OKTA_SCOPES": "okta.users.read okta.groups.read",
        "OKTA_PRIVATE_KEY": "-----BEGIN RSA PRIVATE KEY-----\\nYour private key content here\\n-----END RSA PRIVATE KEY-----",
        "OKTA_KEY_ID": "your-key-id"
      }
    }
  }
}

Description

The Okta Open Source MCP Server is Okta's officially supported bridge between LLM agents and the Okta Admin Management APIs. It reached General Availability in February 2026, with human-oversight controls landing in March and customisation tools, scope-based loading and Device Assurance Policy tools reaching GA in June 2026.

It turns administrative workflows into natural language — "create a new user and add them to the Engineering group", "show me all failed login attempts from the last 24 hours", "list all applications that haven't been used in the past month" — while keeping the guardrails an identity provider needs.

Two design decisions carry most of the safety weight:

Scope-based tool loading. Tools are enabled or disabled at server startup based on the OAuth 2.0 scopes in OKTA_SCOPES. Tools whose scope has not been granted are removed before the first request, so the model never sees them. That enforces least privilege and cuts token consumption at the same time.

Elicitation on destructive actions. Deletes and deactivations prompt the operator for confirmation through the MCP Elicitation API, with an automatic fallback for clients that do not yet implement it.

Authentication supports the Device Authorization Grant for interactive use and Private Key JWT for browserless, server-to-server operation — the latter being the one you want in a container, since Docker cannot open a browser on the host.

Built on Okta's Python SDK v3.4.1; needs Python 3.13+ with the uv package manager, or Docker. Tool coverage spans users, groups, applications, policies, device assurance policies, brands, themes, custom pages, email templates, custom domains and email domains. Apache-2.0.

Best for identity and platform teams who want to automate Okta administration conversationally. Treat the scope configuration as the security boundary: whatever you grant in OKTA_SCOPES is what an agent can do to your directory.

MCP: WorkOS

by WorkOS

WorkOS's official remote MCP server — run your WorkOS dashboard from an agent: organizations, users, SSO connections, Directory Sync, AuthKit branding and audit log streams.

MCP: Auth0

by Auth0

Auth0's official MCP server: create applications, deploy Actions, inspect logs and manage users in your tenant through natural language.

MCP: IDA Pro MCP

by mrexodia

New

Open-source MCP server that lets an agent drive IDA Pro for reverse engineering — decompile, trace cross-references, rename, retype, patch and debug — in the GUI or headless through idalib.

Browse all MCP servers →