Skip to content
VS Code

codex mcp bridge for VS Code

io.github.hampsterx/codex-mcp-bridge

Wraps Codex CLI as MCP tools: codex, review, query, search, structured, ping, listSessions.

client:VS Code transport:stdio runtime:npm

Install codex mcp bridge in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "codex-cli-path",
      "description": "CODEX_CLI_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "codex-default-model",
      "description": "CODEX_DEFAULT_MODEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "codex-fallback-model",
      "description": "CODEX_FALLBACK_MODEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "codex-max-concurrent",
      "description": "CODEX_MAX_CONCURRENT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "codex-mcp-servers",
      "description": "CODEX_MCP_SERVERS",
      "password": true
    }
  ],
  "servers": {
    "codex-mcp-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "env": {
        "CODEX_CLI_PATH": "${input:codex-cli-path}",
        "CODEX_DEFAULT_MODEL": "${input:codex-default-model}",
        "CODEX_FALLBACK_MODEL": "${input:codex-fallback-model}",
        "CODEX_MAX_CONCURRENT": "${input:codex-max-concurrent}",
        "CODEX_MCP_SERVERS": "${input:codex-mcp-servers}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

codex mcp bridge in other clients