> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Monk with Codex

> Enable Monk MCP and make it available to Codex CLI or the Codex IDE extension

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](/getting-started/installation) and writes the config to `.codex/config.toml` in your project.

<Info>
  Want to use Monk without the IDE extension? Install the [Monk agent plugin](/getting-started/agent-plugin-installation) with `codex marketplace add monk-io/monk-plugin`.
</Info>

## Prerequisites

Make sure you have completed the [Monk setup](/getting-started/installation) and the MCP server step shows as running in the setup screen.

## Setup

<Steps>
  <Step title="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.
  </Step>

  <Step title="Verify Monk is listed">
    Run `/mcp` inside Codex. Monk should appear in the active server list.
  </Step>

  <Step title="Start using Monk">
    Ask Codex to use Monk for deployment, infrastructure, or runtime tasks.
  </Step>
</Steps>

<Card title="Deploy your first app" icon="rocket" href="/getting-started/first-deployment" color="#3B82F6">
  Monk is connected — now deploy your project
</Card>

<Card title="Install the agent plugin" icon="plug-circle-plus" href="/getting-started/agent-plugin-installation">
  Direct Codex plugin setup and troubleshooting
</Card>

## 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.

<Card title="More troubleshooting" icon="wrench" href="/getting-started/troubleshooting-installation">
  Common issues and how to fix them
</Card>