v1.0.0 — Linux Computer Use

Screenshot, input, window, clipboard, and app-launch control for Claude on Linux desktops.

Install

Download linux-computer-use-1.0.0.mcpb below and open it with Claude Desktop, then restart Claude Desktop so it picks up the tool list.

Some capabilities need system setup that an extension bundle cannot perform on its own — a udev rule for /dev/uinput, or the bundled GNOME Shell extension. To finish those, either ask Claude to "set up computer use" (the setup tool does everything not needing root and reports the rest), or run:

git clone https://github.com/jslatten/claude-linux-mcp.git
cd claude-linux-mcp
./scripts/setup.sh

The script detects your distro family, architecture, and every installed desktop, does what it can unattended, and lists anything left that needs a password or a re-login.

What works where

	Screenshots	Input	Window control
GNOME (Wayland)	portal	uinput / ydotool	bundled Shell extension, needs a re-login
GNOME (X11)	X11 tools	xdotool	wmctrl — nothing to install
KDE Plasma 5/6	portal / spectacle	uinput / ydotool	KWin scripting — built in
sway, Hyprland	grim	uinput / wtype	compositor IPC
river, Wayfire, niri	grim	uinput / wtype	wlroots foreign-toplevel
Other X11	X11 tools	xdotool	wmctrl

Window control on KDE is a pure-Python D-Bus client driving KWin's scripting engine, so there is no helper binary to compile and x86_64 and aarch64 behave identically.

Verifying

python3 scripts/selftest.py opens a test window and drives the real backends against it. Run it from a terminal you are sitting at — it needs the test window to take keyboard focus, so it will report a typing failure if launched from a background or automation context.

Checksum

bdb44e4a5dd903b042af6418ab150e207301955fac3ae1c22d7d3f090f2866d5  linux-computer-use-1.0.0.mcpb