Skip to content
AgentAtlas

WorkOS · Codex

Add the WorkOS MCP server to Codex

Manage WorkOS organizations, users, SSO, Directory Sync and AuthKit.

Official serverRemoteAuthentication

1. Add the server

Run in your terminal

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

Scopes, env vars, OAuth and limits: Codex MCP config guide

2. Sign in

Run codex mcp login <name> to complete OAuth for a remote server. WorkOS is hosted by WorkOS, so there is nothing to install or keep updated.

3. Try it

Ask Codex for something WorkOS can do. Manage WorkOS organizations, users, SSO, Directory Sync and AuthKit. Approve the first tool call and check the result before allowing write actions automatically.

  • · Each server is a [mcp_servers.<name>] table in config.toml.
  • · Use enabled_tools or disabled_tools to keep the tool list short.

FAQ

How do I add the WorkOS MCP server to Codex?
Run: codex mcp add workos --url https://mcp.workos.com/mcp. Run codex mcp login <name> to complete OAuth for a remote server.
Is this the official WorkOS MCP server?
Yes. It is published by WorkOS as com.workos/mcp in the official MCP registry.
Does the WorkOS MCP server need an API key?
It is a hosted server. Most hosted servers sign you in with OAuth the first time Codex uses them; check WorkOS's docs for any plan or permission requirements.

Links

WorkOS in other clients

More authentication for Codex

Built an MCP server? Get it listed everywhere →

Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →

Reviewed Oct 21, 2026. Command generated from the registry record and checked against Codex's documented syntax.