Skip to main content

​
How This Setup Works

Codex does not run the Monk extension itself. The setup has two parts:
  1. Keep Monk running in a supported IDE with MCP enabled for the project
  2. Open Codex in the same trusted project so it can read the generated MCP config

​
Step 1: Enable Monk MCP on the Monk Side

Monk MCP is not enabled by default. Before you switch to Codex, make sure Monk is already running in VS Code, Cursor, Windsurf, or Antigravity with the same project open. Make sure:
  • Monk is installed in one supported IDE that is currently running
  • the project is open in that IDE
  • you ran Monk: Manage MCP Server
  • you chose Enable MCP server
If you are choosing targets manually, include Codex for this workspace. Monk writes the project-scoped Codex config for you in .codex/config.toml. Read more: Install Monk, MCP Getting Started

​
Step 2: Let Codex Load Monk

Codex supports project-scoped MCP configuration in .codex/config.toml for trusted projects. Monk writes that file for you, so the next step is to open the same project in Codex. This works for both:
  • the Codex CLI
  • the Codex IDE extension, which shares the same MCP configuration
Codex MCP Enablement

​
Step 3: Verify Monk Is Active

In the Codex TUI, run: 
/mcp
Codex documents /mcp as the way to see active MCP servers. You should see Monk listed there once the project config has been picked up. Read more: Codex MCP docs

​
Step 4: Start Using Monk from Codex

Once Monk is active, Codex can call Monk for project operations and deployment work. Try requests like:
  • use Monk to analyze this repository
  • use Monk to deploy this app to AWS
  • ask Monk what infrastructure this service needs
  • use Monk to inspect runtime state and logs

​
If Monk Does Not Appear

  • confirm Monk is running in VS Code, Cursor, Windsurf, or Antigravity
  • confirm Monk MCP is enabled there for this workspace
  • confirm that supported IDE still has the project open
  • confirm Codex is opened in the same project root
  • make sure the project is trusted by Codex
  • run /mcp again