Labsco
MCP SERVER

Deskbrid

by coe0718

Desktop control for Linux agents that survives Wayland — windows, input, clipboard, screenshots, audio, from one binary.

Desktop & OS Automation
Summary
The gap it fills is real: xdotool breaks under Wayland, and Wayland is now the default.

macOS agents have AppleScript and Windows has UI Automation; Linux had a tool that stops working on the display protocol most distributions now ship. Deskbrid detects the compositor and loads a matching backend, so the same tool call works on GNOME and Hyprland without your agent knowing the difference. The repository is unusually direct about where that breaks down — per-compositor gaps are listed by name, with Hyprland missing window minimise and primary monitor control, and some actions stubbed to return not supported. Read that matrix before planning around a specific action.

What it is

A single Rust daemon that detects your desktop environment, loads the right backend for it, and exposes the whole desktop as MCP tools — with the same protocol available over a Unix socket and a CLI.

What you get
  • Windows and workspaces: windows.list, windows.focus by app_id or title, windows.close, windows.move_resize, windows.tile and windows.activate_or_launch, plus saved layout profiles
  • Input: keyboard typing, individual keys and combinations, and full mouse control
  • Clipboard read and write, with history
  • Screenshots, with OCR through Tesseract and a diff between two captures
  • System: desktop info, battery, idle detection, power management, systemd units, journal queries and PTY terminal sessions
  • Monitors, network and Wi-Fi, Bluetooth pairing, MPRIS media control and colour picking
  • Speech output through spd-say or espeak-ng, with voice listing and cancellation
  • More than a hundred MCP tools across twenty categories, including AT-SPI accessibility, files, keyring, notifications, rules, macros and agent messaging
  • A local web dashboard showing system state live, with an audit log of what the agent did
Requirements

Linux, and no account or key — it drives your own session. Install with the published one-line script, which detects the distro and desktop, installs dependencies and sets up uinput; a container image exists as well. Run deskbrid mcp for the MCP server over stdio. Support is uneven by compositor: the repository calls GNOME, KDE Plasma, Hyprland and Sway core and tested, marks Labwc and COSMIC partial, and lists Niri, Wayfire, Cinnamon, MATE and generic X11 as untested code paths.

Setup effort

One command — bash <(curl -fsSL https://deskbrid.patchhive.dev/install.sh)