# WorkOS

The WorkOS MCP server lets an agent inspect and change workspace data, including organizations, users, and SSO. Use it to manage WorkOS through a coding assistant.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: workos
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/workos/skills/tree/HEAD/mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/workos

## What it does

The server gives an agent access to WorkOS operations through the API. It can read information such as organizations and users, and perform actions such as creating an organization or sending an invitation. Its operation catalog also covers SSO, Directory Sync, AuthKit, webhooks, and feature flags.

The agent inherits the permissions of your WorkOS account and handles one environment at a time, starting in a sandbox. Irreversible changes need explicit confirmation. That safeguard matters, but write operations still require an account role that permits them.

Connection uses OAuth 2.1. On first use, sign in and approve access; there’s no API key to paste. The server is hosted remotely, and team settings can restrict or disable MCP access.

## Requirements
- Remote server: `https://mcp.workos.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.workos.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp --url https://mcp.workos.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://mcp.workos.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://mcp.workos.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://mcp.workos.com/mcp
```

## When to use it
- find organizations and users in WorkOS
- create an organization and invite its users
- inspect available operations and their parameters
- investigate an SSO sign-in problem
- adjust branding for an AuthKit sign-in page

## Example prompts
- Show me the WorkOS organizations available in this environment.
- Create an organization called Acme Corp and invite the people listed in `acme_employees.csv`.
- Look into why users in `org_123` are having trouble signing in with SSO.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [workos/skills](https://affpapa.org/en/nevibecode/by/workos/skills.md) — 3 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md