Skip to content
MCP server

kwin-mcp

MCP server giving AI agents GUI automation and testing for KDE Plasma 6 Wayland apps

Pricing
Open source
Platforms
Linux, CLI, self-hosted
Version
0.9.0
Listing updated
today

Similar MCP servers

About kwin-mcp

kwin-mcp is an open-source MCP server for developer tools. It is available on Linux, CLI and self-hosted.

The README says this server lets MCP clients such as Claude Code drive Wayland applications on KDE Plasma 6 by launching them inside a separate virtual KWin session, so the host desktop stays untouched. Agents get mouse, keyboard, touch and clipboard input, screenshots, and an AT-SPI2 accessibility tree that exposes widget roles, names, states and screen coordinates, so they can often act on UI elements without relying only on vision.

The server also supports connecting to a live KWin session, either a real desktop or a KWin instance inside a container such as systemd-nspawn, for shared-screen workflows. Input is injected through KWin's private EIS D-Bus interface via libei, which the README says avoids the portal authorization dialog. It is a fork of isac322/kwin-mcp and is installed from git rather than from the PyPI package of the same name.

It suits developers and QA engineers who want end-to-end GUI tests or agent-driven workflows for Qt, GTK or Electron apps on Linux, including headless CI runners.

What it does

Isolated virtual sessions
Each session runs in its own private D-Bus bus and virtual KWin Wayland compositor, separate from the host desktop.
Accessibility tree inspection
Reads the AT-SPI2 widget tree with roles, names, states and screen coordinates to locate UI elements.
Full input coverage
Mouse, keyboard, multi-touch gestures and clipboard input are injected through KWin's EIS interface.
Burst screenshot capture
Action tools can capture frames at set delays to observe transient UI states like hover and animations.
Live session connection
Attaches to an existing KDE desktop or a KWin instance inside a container for collaborative sessions.
Optional home isolation
Can run apps with a temporary HOME and isolated XDG directories so host settings are not touched.

Good for

  • Run end-to-end GUI tests for KDE, Qt or GTK applications without a physical display
  • Let an AI agent such as Claude Code operate a desktop application and verify results with screenshots
  • Share a live KDE Plasma desktop with an agent for collaborative troubleshooting
  • Add Linux GUI testing to headless CI pipelines such as GitHub Actions runners
  • Automate kiosk or embedded KWin interfaces for testing and diagnostics

Pricing

Open source

Open source under the MIT licence; free to self-host.

kwin-mcp FAQ

Which desktop environment is required?

KDE Plasma 6 on a Wayland session is required. The README says GNOME, Sway and older KDE versions are not supported.

Does it need a user authorization dialog to send input?

The README says input goes through KWin's private EIS D-Bus interface directly, bypassing the XDG RemoteDesktop portal, so no confirmation dialogs are shown.

Which keyboard layouts does typing support?

keyboard_type supports US QWERTY only. Non-ASCII text can be typed with keyboard_type_unicode, which needs wtype or wl-clipboard installed.

How do I install it?

The README recommends uv tool install from the git repository. The PyPI package of the same name tracks the upstream project, not this fork.

Is kwin-mcp free?

Yes. kwin-mcp is open source, so you can use and self-host it for free.

What are the best alternatives to kwin-mcp?

The closest alternatives to kwin-mcp are simplify3x-connect, Swing MCP, Mobai MCP, Qualien MCP and Chrome DevTools MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.

How AIPoweredBot checks servers