Installation

Installation

Prerequisites

• Python 3.10+
• uv (recommended; the GUI installer can bootstrap it)
• Windows: works out of the box (mouse/keyboard via pyautogui, windows via pygetwindow, background input/capture/headless via Win32 ctypes, screenshots via mss, recording via imageio + bundled ffmpeg). Optional: AutoHotkey, WSL.
• Linux: needs an X11 (or XWayland) session and the X11 helpers — see Linux Support.

Option 1 — GUI installer (fully automatic) ✅ recommended

It installs uv if missing, runs uv sync, registers the server with Claude Code and Codex, and enables YOLO mode — automatically on launch.

Clone the repo:

git clone https://github.com/codingmachineedge/lowlevel-computer-use-mcp.git

Enter it:

cd lowlevel-computer-use-mcp

Launch the installer (it auto-runs the full install):

uv run lowlevel-computer-use-mcp-installer

Then restart Claude Code / Codex so they spawn the server.

Option 2 — manual with uv

From the repo directory, start the stdio server (uv resolves deps on first run):

uv run lowlevel-computer-use-mcp

Option 3 — manual with pip

Install in editable mode:

pip install -e .

Then run it:

lowlevel-computer-use-mcp

Capture output location

Screenshots and recordings default to ~/lowlevel-computer-use-captures. Override with the LOWLEVEL_CU_CAPTURE_DIR environment variable, or pass an explicit output_path to any capture tool.

Next steps

• Registering Clients — wire it into Claude Code / Codex and enable YOLO mode.
• Tool Reference — what every tool does.