# kwin-mcp

> kwin-mcp is an open-source MCP server for developer tools. MCP server giving AI agents GUI automation and testing for KDE Plasma 6 Wayland apps. It is available on Linux, CLI and self-hosted.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Repository:** https://github.com/vibeprogramm/kwin-mcp
- **MCP Registry name:** io.github.VibeProgramm/kwin-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## 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.

## Alternatives

- [simplify3x-connect](https://ai-powered.com/mcp/simplify3x-connect): simplify3x-connect is an open-source MCP server for developer tools.
- [Swing MCP](https://ai-powered.com/mcp/swing-mcp): Swing MCP is an open-source MCP server for developer tools.
- [Mobai MCP](https://ai-powered.com/mcp/mobai-mcp): Mobai MCP is an open-source MCP server for developer tools.
- [Qualien MCP](https://ai-powered.com/mcp/qualien-mcp): Qualien MCP is an open-source MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-4): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [McpMux](https://ai-powered.com/mcp/mcpmux-2): McpMux is an open-source MCP server for developer tools.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.
- [bad-ass-mcp](https://ai-powered.com/mcp/bad-ass-mcp): bad-ass-mcp is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kwin-mcp
