# WorkOS MCP server

> Manage WorkOS organizations, users, SSO connections, directories, and AuthKit branding through the WorkOS API.

- Repository: https://github.com/workos/skills
- Page: https://hostedmcp.org/servers/workos/mcp
- Transport: remote
- Stars: 46
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http mcp https://mcp.workos.com/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.workos.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.workos.com/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workos.com/mcp"}'
```

### Codex

```sh
codex mcp add mcp --url https://mcp.workos.com/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
url = "https://mcp.workos.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http mcp https://mcp.workos.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.workos.com/mcp",
      "type": "http"
    }
  }
}
```

## Tools (5)

- `whoami`
- `list_operations`
- `query`
- `mutate`
- `setup_account`

## FAQ

### How does the WorkOS MCP server authenticate?

It uses OAuth 2.1 with Dynamic Client Registration through WorkOS Connect, so you sign in through a consent screen instead of pasting API keys.

### What permissions does the WorkOS MCP agent have?

The agent acts as your account and inherits your dashboard role, so a read-only role cannot make changes. It works in one environment at a time and defaults to a sandbox.

### What can the WorkOS MCP server do?

It runs read-only and write operations covering organizations, users, SSO connections, Directory Sync, AuthKit branding, webhooks, and feature flags.

### Does WorkOS MCP require confirmation for destructive actions?

Yes, irreversible operations like deleting an organization, connection, or directory return a description of what will be destroyed and require explicit confirmation first.
