Kapilduraphe Okta MCP Server

🚀 Okta Management Control Plane (MCP) Server

This MCP server enables Claude to interact with Okta's user management system, providing user and group management capabilities.

🚀 Quick Start

Prerequisites

• Node.js (v16 or higher)
• Claude Desktop Application
• Okta Developer Account
• Okta Admin API Token

Setup Instructions

1. Create an Okta Developer Account

• Visit the Okta Developer Console.
• Create a new account or log in to an existing one.
• Record your Okta domain name (e.g., dev-123456.okta.com).

2. Create an API Token

• In the Okta Developer Console, go to "Security" > "API Tokens".
• Click "Create Token".
• Fill in the necessary information and save the token.

3. Configure the Claude Desktop Application

• Open the Claude Desktop Application.
• Navigate to "Settings" > "Integrations".
• Add the details of the Okta MCP server, including the domain name and API token.

✨ Features

• User Management: Create, update, and delete users.
• Group Management: Manage user groups and their memberships.
• Authentication: Integrate Okta's multi - factor authentication features.

🔧 Technical Details

Error Handling

• Common Errors: Check the logs for detailed error information.
• Retry Mechanism: It is recommended to set up a retry strategy when API calls fail.
• Rate Limiting: Okta has certain rate limits for API requests. Refer to its documentation for specific limits.

Type Definitions

The server includes TypeScript interfaces to describe Okta user and group data:

interface OktaUserProfile {
  login: string;
  email: string;
  secondEmail?: string;
  firstName: string;
  lastName: string;
  displayName: string;
  nickName?: string;
  organization: string;
  title: string;
  division: string;
  department: string;
  employeeNumber: string;
  userType: string;
  costCenter: string;
  mobilePhone?: string;
  primaryPhone?: string;
  streetAddress: string;
  city: string;
  state: string;
  zipCode: string;
  countryCode: string;
  preferredLanguage: string;
  profileUrl?: string;
}

interface OktaUser {
  id: string;
  status: string;
  created: string;
  activated: string;
  lastLogin: string;
  lastUpdated: string;
  statusChanged: string;
  passwordChanged: string;
  profile: OktaUserProfile;
}

interface OktaGroup {
  id: string;
  created: string;
  lastUpdated: string;
  lastMembershipUpdated: string;
  type: string;
  objectClass: string[];
  profile: {
    name: string;
    description: string;
  };
}

📄 License

This project is under the MIT License. See the LICENSE file for details.

💡 Usage Tip

If you encounter any issues:

• Check the troubleshooting section.
• View the Claude desktop logs.
• Refer to Okta's developer documentation.

Note: Pull requests are welcome!