How do I use codex-cua-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@codex-cua-mcp open Notepad and type 'Hello World'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

codex-cua-mcp

by RS-Nocsi

Overview Schema Related Servers Score Discussions

TypeScript

Local

Codex CUA MCP

中文版

💬 LINUX DO Discussion

Wraps Codex's Computer Use capability as an MCP server, 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, and more
Launch apps and activate windows
Ready to use - exe bundled, no extra setup needed

Related MCP server: MCPControl

Quick Start

Hand the install doc to your AI agent — send this prompt:

Please clone the repository https://github.com/RS-Nocsi/codex-cua-mcp locally, read its INSTALL.md, and install this MCP server into your own MCP configuration by following it.

Your agent (Claude Code, Cursor, Windsurf, Cline, OpenCode, Gemini CLI, etc.) will clone the repo, check prerequisites, build the project, and register the server itself. Fully restart the agent afterwards.

Prefer manual setup? Follow INSTALL.md yourself.

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.

Dynamic agent name

The desktop overlay shows which agent is controlling the computer (e.g. "Claude Code is using your computer"). Please set the CUA_AGENT_NAME environment variable to your own display name in the registration — see INSTALL.md Step 4. Each agent has its own runtime config under config-runtime/; multiple agents can install this MCP simultaneously without conflict.

📖 Want to understand the design in depth? Read the Architecture Deep Dive.

Available Tools

Tool	Description
`list_windows`	List all controllable windows
`list_apps`	List installed apps
`get_window`	Rehydrate a window object
`launch_app`	Launch an application
`activate_window`	Bring window to foreground
`get_window_state`	Screenshot + accessibility tree
`click`	Click
`type_text`	Type text
`press_key`	Press key
`scroll`	Scroll
`drag`	Drag
`set_value`	Set input field value
`perform_secondary_action`	Secondary action (right-click menu, etc.)

Disclaimer

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

Requirements

Windows 10/11
Node.js 18+

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

Windows-MCP
Shell Access Open Data
StepByStep-1
A
license
-
quality
D
maintenance
Enables AI agents to interact with Windows operating systems through native UI automation, file navigation, application control, and system commands. Provides seamless integration between LLMs and Windows environments for tasks like clicking, typing, launching apps, and capturing desktop state.
Last updated 2025-08-16
MIT
MCPControl
OS Automation App Automation
claude-did-this
A
license
-
quality
D
maintenance
Provides programmatic control over Windows systems, enabling AI models to interact with the desktop through mouse movements, keyboard input, window management, screen capture, and clipboard operations.
Last updated 2025-12-02
174
330
MIT
jenny-mcp-server
Browser Automation File Systems Version Control
RhaDar12
F
license
-
quality
B
maintenance
Enables AI agents to interact with the Windows desktop environment, including browser control, clipboard, file management, GitHub, Roblox Studio, OCR, and more, with a privileged approval system for risky actions.
Last updated 2026-06-15
WinPilot Computer Use MCP
App Automation Autonomous Agents
omidmanoochehri
F
license
-
quality
C
maintenance
Enables AI agents to control Windows GUI applications like a human using screen capture, OCR, mouse and keyboard input, and window management, with safety levels and memory.
Last updated 2026-07-01

View all related MCP servers

Related MCP Connectors

Glasswarp
Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.
agentmailrooms-mcp
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
local-mcp
Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RS-Nocsi/codex-cua-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server