MCP Directory

How to add Cua Driver to Cursor

Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 14, 2026 · 19k★ · stdio · no auth

Cursor config for Cua Driver

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
{
  "mcpServers": {
    "cua-driver": {
      "command": "cua-driver",
      "args": [
        "mcp"
      ]
    }
  }
}

Setup steps

  1. 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Cua Driver config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Cua Driver's tools to confirm it's connected.

Before you start

  • macOS 14 (Sonoma) or newer for the macOS backend (Windows and pre-release Linux backends also supported)
  • cua-driver CLI + CuaDriver.app installed via the install.sh / install.ps1 one-liner
  • macOS: Accessibility and Screen Recording permissions granted to CuaDriver.app (verify with `cua-driver check_permissions`)
  • An MCP client such as Claude Code, Cursor, Codex, or a custom client

What Cua Driver can do in Cursor

get_window_state

Snapshot a window's accessibility tree (Screen-of-Marks markdown with each actionable element tagged [N]) plus an optional screenshot; required before acting by element_index.

get_desktop_state

Capture the overall desktop / multi-window state.

list_apps

App-level discovery: list installed / running applications.

list_windows

List the windows for a given pid.

launch_app

Launch (or focus) an app by bundle id; idempotent and returns the pid plus a windows array.

kill_app

Terminate a running application by pid.

bring_to_front

Bring an app/window to the foreground when foreground interaction is needed.

click

Click a target by element_index (AX/UIA) or by pixel x/y within a window, without raising it.

Security

Runs locally and drives the user's real desktop. On macOS it ships as an .app bundle (com.trycua.driver) and requires Accessibility and Screen Recording TCC grants in System Settings -> Privacy & Security; verify with `cua-driver check_permissions`. Requires macOS 14 (Sonoma) or newer. It can control any granted application, so only run it on machines where you trust the connected agent. No API key or remote auth is used.

Cua Driver + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Cua Driver config there under the "mcpServers" key and restart the client.

Is Cua Driver safe to use with Cursor?

Runs locally and drives the user's real desktop. On macOS it ships as an .app bundle (com.trycua.driver) and requires Accessibility and Screen Recording TCC grants in System Settings -> Privacy & Security; verify with `cua-driver check_permissions`. Requires macOS 14 (Sonoma) or newer. It can control any granted application, so only run it on machines where you trust the connected agent. No API key or remote auth is used.

How do I add it to Claude Code?

Install the driver with the install.sh one-liner, then run `claude mcp add --transport stdio cua-driver -- cua-driver mcp`. For Claude Code's vision/computer-use grounding, register the compat server instead: `claude mcp add --transport stdio cua-computer-use -- cua-driver mcp --claude-code-computer-use-compat`.

Which platforms are supported?

macOS and Windows are supported with the same CLI/MCP server; Linux is available as a pre-release backend while platform testing continues. The macOS backend requires macOS 14 (Sonoma) or newer.

What permissions does it need?

On macOS, CuaDriver.app needs Accessibility and Screen Recording grants in System Settings -> Privacy & Security. Verify both are true with `cua-driver check_permissions`. No API key is required.

View repo Full Cua Driver page