Install and initialize the Okta MCP server

Get started with the Okta Model Context Protocol (MCP) server setup and prerequisites.

---

Learning outcomes

• Verify the prerequisites 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. To learn about the Okta MCP server architecture, see the introductory page on 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 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 API scopes.