Connect Codex to Runn
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 Runn
A preset of real Runn operations. Each one becomes a tool the agent can call, and it can't touch anything outside the list.
Connect Runn
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
Runn
18 toolsWho am I? in the connected Runn account.
List projects in the connected Runn account.
Show a project in the connected Runn account.
Create a project in the connected Runn account.
Update a project in the connected Runn account.
List people in the connected Runn account.
Show a person or placeholder in the connected Runn account.
Create a person in the connected Runn account.
Update a person or placeholder in the connected Runn account.
List clients in the connected Runn account.
Create a client in the connected Runn account.
List assignments in the connected Runn account.
Create an assignment in the connected Runn account.
List actuals in the connected Runn account.
Create or overwrite an actual in the connected Runn account.
List leave time offs in the connected Runn account.
Create a leave time off in the connected Runn account.
List roles in the connected Runn account.
About Codex
Frequently asked questions
More ways to connect
Open your Codex agent in one click.
NoClick runs Codex for you with Runn wired in as tools. Connect your account and run.