---
title: "WorkOS Integration"
description: "Manage WorkOS organizations, AuthKit users, memberships, and directory sync"
---
The WorkOS integration provides access to manage WorkOS organizations, AuthKit users, memberships, and directory sync through the Integrate MCP server.

## Installation

The WorkOS integration is included with the SDK:

```typescript
import { workosIntegration } from "integrate-sdk/server";
```

## Setup

Add WorkOS to your server configuration. Provide credentials via environment variables or integration config:

```typescript
import { createMCPServer, workosIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    workosIntegration({
      // See configuration options below
    }),
  ],
});
```

### Client-Side Usage

```typescript
import { client } from "integrate-sdk";

const result = await client.workos.listOrganizations({});

console.log(result);
```

## Environment Variables

- `WORKOS_API_KEY` (when supported by this integration)

## Configuration Options

<AutoTypeTable
  path="../src/integrations/workos.ts"
  name="WorkOSIntegrationOptions"
/>


## Tools

### `workos_list_organizations`

List organizations

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosListOrganizationsParams"
/>

### `workos_get_organization`

Get organization

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosGetOrganizationParams"
/>

### `workos_create_organization`

Create organization

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosCreateOrganizationParams"
/>

### `workos_update_organization`

Update organization

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosUpdateOrganizationParams"
/>

### `workos_list_users`

List users

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosListUsersParams"
/>

### `workos_get_user`

Get user

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosGetUserParams"
/>

### `workos_list_organization_memberships`

List organization memberships

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosListOrganizationMembershipsParams"
/>

### `workos_list_directories`

List directories

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosListDirectoriesParams"
/>

### `workos_get_directory`

Get directory

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosGetDirectoryParams"
/>

### `workos_list_directory_users`

List directory users

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosListDirectoryUsersParams"
/>

### `workos_get_directory_user`

Get directory user

<AutoTypeTable
  path="generated/tool-params/workos.ts"
  name="WorkosGetDirectoryUserParams"
/>

## Notes

- Category: Identity & Access
- Authentication mode: API key