# Computer Use Turbo [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/afaaq-io/ComputerUseTurbo  
**GitHub Stars:** 2  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/computer-use-turbo

## Description
Let any AI agent operate desktop apps on macOS, Windows and Linux, in the background and safely.

## Tools
Capabilities this server exposes over MCP:

- **find_apps** — Lists the apps the agent can target, running apps first, then system panels
- **observe_app** — Returns the app's interface as numbered lines plus a screenshot; later calls report only changes
- **click_at** — Clicks an element by number, or a point on the screenshot
- **write_text** — Types text, through accessibility where possible
- **send_keys** — Presses a key or key combination (`cmd+s`, `Return`, `ctrl+shift+Tab`)
- **fill_value** — Replaces a field's value directly
- **pick_text** — Selects text inside a field, or places the caret before or after it
- **scroll_view** — Scrolls at an element or point
- **drag_item** — Drags between two points on the screenshot
- **paste_text** — Pastes plain text, Markdown or HTML; your clipboard is restored afterwards
- **invoke_action** — Runs an element's named accessibility action
- **find_command** — Searches an app's menu commands and their shortcuts
- **run_command** — Runs a menu command by its path, in the background
- **wait_for** — Waits until text appears or disappears, an element changes, a window opens or the app settles
- **run_steps** — Runs several actions in one call, each fully checked, ending with a fresh observation
- **show_preview** — Shows or hides the live preview
- **access_status** — Checks, or requests, the helper's permissions
- **finish** — Ends the session when the task is complete

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "computer-use-turbo": {
    "command": "npx",
    "args": ["-y","computer-use-turbo"]
  }
}
```

## Documentation

## What Computer Use Turbo MCP server does

Computer Use Turbo MCP server connects an MCP client to desktop applications on macOS, Windows, and Linux. It can discover available applications, inspect a window, interact with controls, enter or paste content, use keyboard shortcuts, operate menus, and wait for visible or structural changes.

The agent receives an app representation as numbered accessibility-tree lines together with a screenshot. This lets it target a reported element or coordinate instead of relying only on image interpretation. The server can also expose system panels such as Control Center, Notification Center, and Spotlight through available menu-bar status items.

## How it works

The Node.js MCP server communicates with the agent over standard input and output. It validates tool arguments, identifies the connected agent, starts the helper when needed, and converts screenshots into MCP image content. A platform-specific helper performs the actual application access, screen capture, input synthesis, and safety enforcement.

On macOS, the helper uses Accessibility APIs, ScreenCaptureKit, and CGEvent. Windows uses UI Automation, PrintWindow, and SendInput. Linux uses AT-SPI, with XTest on X11 and desktop portals, PipeWire, and libei on Wayland.

Applications can remain behind other windows during most operations, and the agent does not move the user's mouse. A live preview can show the activity. Certain operations, including some menu-bar interactions, file drags, and applications with custom-rendered interfaces, may briefly bring an app forward while the user is idle.

## Setup and configuration

Installation requires Node.js 20 or newer and Git. Clone the repository, build and install the helper for the host operating system, then add `server/src/server.mjs` as an MCP server using the name `turbo`.

macOS requires version 14 or later plus Xcode or the Command Line Tools. Accessibility and Screen & System Audio Recording permissions must be granted in System Settings. Windows requires Rust with the MSVC toolchain and does not require permission grants. Linux requires Rust, an accessibility-enabled desktop session, and development packages for PipeWire, xkbcommon, and clang. Wayland also requires a desktop portal with RemoteDesktop and ScreenCast support.

Claude Code and Codex provide documented commands for registering the server. Other MCP clients can use the generated configuration from `scripts/mcp-config.sh` or its PowerShell equivalent on Windows.

## Tools and capabilities

Computer Use Turbo MCP server exposes tools for the full interaction loop:

- Discover applications and inspect their current interface with `find_apps` and `observe_app`.
- Click controls, type or replace values, select field text, scroll, drag, and paste plain text, Markdown, or HTML.
- Send key chords, invoke named accessibility actions, and search or run application menu commands.
- Wait for text, element changes, windows, or application settling before continuing.
- Batch checked actions with `run_steps`, display or hide the preview, inspect permissions, and end a session with `finish`.

Later observations report changes rather than repeating the entire state where possible. `run_command` can execute a menu command without opening the menu, while `wait_for` responds to application events instead of requiring polling.

## Limitations and notes

Password fields are not typed into automatically. Password-manager use requires confirmation, and system authentication remains protected. The user's agent permissions remain in control, and the helper is the only component that directly touches applications.

A signing certificate is recommended for macOS because rebuilding without one can require permissions to be granted again. Linux Wayland setup depends on a compatible desktop portal. Applications that do not expose usable accessibility information or that draw their own interface may require foreground handling and may provide less reliable targeting.

_Full upstream README: https://allmcps.com/mcp/computer-use-turbo/readme_