Connect Codex to WorkOS
Set up in minutes
Choose where it runs
On your computer through your own Codex, or hosted in the cloud. The rest of setup adapts to your choice:
Pick what it can do in WorkOS
A preset of real WorkOS operations. Each one becomes a tool the agent can call, and it can't touch anything outside the list.
Connect WorkOS
One sign-in. The agent acts through your account, scoped to the operations you picked.
Add your personal MCP link
The last step mints a private MCP URL for this agent and walks you through exactly this, with your real link filled in. The page flips to Connected the moment your Codex first calls in. Codex connects when a session starts — run codex, or restart a running one (in the Codex app, Restart).
Run this in your terminal. The Codex app shares its config, so it gets the server too
<your-link> is your personal server URL — setup mints it for you.
Tools Codex gets
WorkOS
23 toolsList organizations in the connected WorkOS environment.
Get organization in the connected WorkOS environment.
Create organization in the connected WorkOS environment.
Update organization in the connected WorkOS environment.
Delete organization in the connected WorkOS environment.
List users in the connected WorkOS environment.
Get user in the connected WorkOS environment.
Create user in the connected WorkOS environment.
Update user in the connected WorkOS environment.
Delete user in the connected WorkOS environment.
List memberships in the connected WorkOS environment.
Get membership in the connected WorkOS environment.
Create membership in the connected WorkOS environment.
Update membership in the connected WorkOS environment.
Delete membership in the connected WorkOS environment.
List directories in the connected WorkOS environment.
Get directory in the connected WorkOS environment.
List directory users in the connected WorkOS environment.
Get directory user in the connected WorkOS environment.
List directory groups in the connected WorkOS environment.
Get directory group in the connected WorkOS environment.
List connections in the connected WorkOS environment.
Get connection in the connected WorkOS environment.
About Codex
Frequently asked questions
More ways to connect
Open your Codex agent in one click.
NoClick runs Codex for you with WorkOS wired in as tools. Connect your account and run.