Skip to main content
Codex runs separately from the Monk extension. You keep Monk open in your IDE and launch Codex in the same project directory. This works for both the Codex CLI and the Codex IDE extension. The Monk MCP server is enabled automatically during setup and writes the config to .codex/config.toml in your project.
Want to use Monk without the IDE extension? Install the Monk agent plugin with codex marketplace add monk-io/monk-plugin.

​
Prerequisites

Make sure you have completed the Monk setup and the MCP server step shows as running in the setup screen.

​
Setup

1

Open Codex in the same directory

Launch Codex CLI or open the project in the Codex IDE extension. Make sure the project is trusted by Codex so it reads the config.
2

Verify Monk is listed

Run /mcp inside Codex. Monk should appear in the active server list.
3

Start using Monk

Ask Codex to use Monk for deployment, infrastructure, or runtime tasks.

Deploy your first app

Monk is connected — now deploy your project

Install the agent plugin

Direct Codex plugin setup and troubleshooting

​
Troubleshooting

If Monk does not appear in /mcp, confirm the IDE with Monk is still running with the same project open and MCP is enabled. Make sure the project is trusted by Codex and that Codex is opened at the correct project root.

More troubleshooting

Common issues and how to fix them