Computer Use Turbo MCP server

Computer Use Turbo

Let any AI agent operate the desktop apps on your computer in the background, safely, with you in control.

Computer Use Turbo is a cross-platform computer-use toolkit developed by afaaq.io. It gives AI agents a fast, reliable way to see and operate real desktop applications on macOS, Windows and Linux. Instead of guessing from pixels alone, the agent reads each app's accessibility tree as numbered lines, sees a screenshot of the window, and acts on exact elements while you keep using your computer.

It speaks the open Model Context Protocol (MCP), so it works with any MCP-capable agent: desktop assistants, IDE agents, command-line agents and agent SDKs.

Contents

• Installation
• Highlights
• Supported platforms
• Architecture
• Components
• Tools
• Safety and privacy
• Configuration
• Development
• Troubleshooting
• License

Installation

Every platform needs Node.js 20 or later and Git. Installing takes three steps: get the code, build the helper for your system, then connect your agent.

1. Get the code

git clone https://github.com/afaaq-io/ComputerUseTurbo.git

cd ComputerUseTurbo

2. Build and install the helper

macOS

Requirements: macOS 14 or later and Xcode or the Command Line Tools. An Apple Development signing certificate is recommended; without one, macOS forgets the granted permissions after every rebuild.

scripts/build.sh

scripts/install.sh

Then allow Computer Use Turbo in System Settings ▸ Privacy & Security under Accessibility and Screen & System Audio Recording. The installer prints shortcuts to both panes.

Windows

Requirements: Rust with the MSVC toolchain. In PowerShell:

scripts\build.ps1

scripts\install.ps1

The helper is installed to %LOCALAPPDATA%\Programs\ComputerUseTurbo. No permission grants are needed.

Linux

Requirements: Rust, a desktop session with accessibility (AT-SPI) enabled, and the PipeWire, xkbcommon and clang development packages (on Debian and Ubuntu: libpipewire-0.3-dev libspa-0.2-dev libxkbcommon-dev clang libclang-dev). Wayland sessions need a desktop portal with RemoteDesktop and ScreenCast support (GNOME, KDE Plasma, COSMIC).

scripts/build.sh

scripts/install.sh

The helper is installed to ~/.local/bin/computer-use-turbo-helper. On Wayland, the installer asks you once to allow screen sharing. To enable accessibility on GNOME:

gsettings set org.gnome.desktop.interface toolkit-accessibility true

3. Connect your agent

The MCP server is server/src/server.mjs inside your copy. In the commands below, replace /path/to/ComputerUseTurbo with the folder you cloned into (pwd prints it).

The server is named turbo because some agent apps reserve names beginning with "computer-use" for their own built-in tools.

Claude Code

Install the plugin from the afaaq.io marketplace:

claude plugin marketplace add afaaq-io/ComputerUseTurbo

claude plugin install computer-use-turbo@afaaq-io

Or add the server from your copy directly:

claude mcp add --scope user turbo -- node /path/to/ComputerUseTurbo/server/src/server.mjs

Check it with claude mcp list, then start a new Claude Code session.

Codex

codex mcp add turbo -- node /path/to/ComputerUseTurbo/server/src/server.mjs

Or add it to ~/.codex/config.toml by hand:

Shortened. The full README is on GitHub.