Install and initialize the Okta Open Source MCP Server

Get started with the Okta Open Source Model Context Protocol (MCP) server setup, prerequisites, and Python SDK v3.4.1 requirements.

---

Learning outcomes

• Verify the prerequisites, ensure SDK v3.4.1 compatibility, and initialize your local Okta Open Source MCP Server project.

What you need

• An Okta Integrator Free Plan org (opens new window) with admin permissions.
• Select an admin role. See Learn about administrators (opens new window).
• The uv (opens new window) package manager.
• Python 3.8 (opens new window) or higher.

---

Overview

This guide explains how to initialize the Okta Open Source MCP Server project and install the required dependencies, including Okta's Python SDK v3.4.1. See Manage Okta APIs with the Okta Open Source MCP Server.

---

Install and configure the Okta Open Source MCP Server

Set up the project

Install and configure the Okta Open Source MCP Server project for integration with your chosen MCP client.

1. Initialize the Okta Open Source MCP Server project:

   # Clone the Git repo
   git clone https://github.com/okta/okta-mcp-server.git
   
   # Change directory
   cd okta-mcp-server
   

2. Install the Okta Python SDK v3.4.1 and other required dependencies and set up the project:

   uv sync
   

---

Next steps

Set up Okta app authentication for the Okta Open Source MCP Server to create the required credentials and grant the specific OAuth 2.0 scopes that are required to load tools at startup.