WorkOS — Claude Code MCP server: features and setup
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.
claude mcp add --transport http mcp https://mcp.workos.com/mcpWhat WorkOS 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.
What it helps with
- 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 for the agent
- 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_123are having trouble signing in with SSO.
How to install WorkOS
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.workos.com/mcpPlatform CLI: remote server
codex mcp add mcp --url https://mcp.workos.com/mcpConfig file
{
"mcpServers": {
"mcp": {
"url": "https://mcp.workos.com/mcp"
}
}
}Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.workos.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http mcp https://mcp.workos.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WorkOS
How do I install WorkOS in Claude Code?
Run claude mcp add --transport http mcp https://mcp.workos.com/mcp. On the first connection, sign in to WorkOS and approve access.
What does the WorkOS MCP server do?
It lets an agent read WorkOS data and carry out permitted operations involving organizations, users, SSO, and other service features.
What permissions does the WorkOS agent use?
It acts with the role of your WorkOS account and accesses one environment at a time. Irreversible operations require explicit confirmation.
