Install and initialize the Okta MCP server

Get started with the Okta 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 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 MCP server project and install the required dependencies, including Okta's Python SDK v3.4.1. See Manage Okta APIs with the Okta MCP server.

---

Install and configure the Okta MCP server

Set up the project

Install and configure the Okta MCP server project for integration with your chosen MCP client.

1. Initialize the Okta 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 MCP server to create the required credentials and grant the specific OAuth 2.0 scopes that are required to load tools at startup.