Codex CUA MCP

中文版

💬 LINUX DO Discussion

MCP server that wraps Codex's Computer Use capability, enabling AI agents to control Windows desktop applications.

Features

• List and control Windows desktop applications

• Capture screenshots and accessibility trees

• Click, type, press keys, scroll, drag

• Launch apps and activate windows

• Ready to use - exe bundled, no extra setup needed

Related MCP server: MCPControl

Quick Start (Claude Code)

git clone <repo-url>
cd codex-cua-mcp
.\setup.ps1

Restart Claude Code to use.

Other Agents

Works with any MCP-compatible agent (Cursor, Windsurf, Cline, etc.):

{
  "mcpServers": {
    "codex-cua": {
      "command": "node",
      "args": ["PATH/codex-cua-mcp/bin/codex-cua-mcp.js"]
    }
  }
}

Check your agent's documentation for config file location.

How It Works

AI Agent (Claude Code, Cursor, etc.)
  ↓ MCP protocol (stdio)
MCP Server (codex-cua-mcp)
  ↓ JSON-RPC (stdin/stdout)
codex-computer-use.exe
  ↓ Windows APIs
Desktop Applications

The MCP server communicates with codex-computer-use.exe via JSON-RPC over stdin/stdout. The exe uses Windows APIs (SendInput, UI Automation, Windows.Graphics.Capture) to interact with desktop applications.

Each action requires an approval flow on first use per app. The server auto-approves by default for seamless operation.

📖 Want to understand the design in depth? Read the Architecture Deep Dive. (中文版)

Available Tools

Disclaimer

The core functionality comes from codex-computer-use.exe. Actual results depend on the AI agent and model being used — no guarantee of usability.

Requirements

• Windows 10/11

• Node.js 18+

License

MIT