K
Kwin MCP
Automates KDE Plasma 6 Wayland desktops through 29 MCP tools in isolated virtual or live KWin sessions.
Install Kwin MCP
Pick your client, then add it in one click or paste the config.
~/Library/Application Support/Claude/claude_desktop_config.json{
"mcpServers": {
"kwin-mcp-2": {
"command": "uvx",
"args": [
"kwin-mcp"
]
}
}
}
Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.
Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.
Overview
Use cases
- Run end-to-end GUI tests for Wayland applications
- Automate KDE desktop workflows with an AI agent
- Inspect and interact with accessibility-tree elements
- Test kiosk interfaces in virtual KWin sessions
- Connect to a live or containerized KWin desktop
Key features
- 29 MCP tools for KDE Wayland automation
- Isolated virtual KWin sessions
- Live KWin session connections
- AT-SPI2 accessibility-tree inspection
- Mouse, keyboard, touch, and clipboard control
- Structured tool output with MCP schemas
How Kwin MCP works
Tools29
What Kwin MCP lets your agent do. Expand a tool for its parameters.
Security & health
What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.
ActiveLast checked 2d ago
Recent health check succeeded.
Supply-chain signal
No high-severity advisories surfaced by our automated scan.
Critical 0High 0Medium 0Low 0
Scanned 2d ago via OSV.dev · kwin-mcp (PyPI)
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
GitHub stars71Stargazers on the source repository.
Last commit2d agoMost recent push to the default branch.
Tools exposed29Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.
Reviews
No reviews yet — be the first to share how it worked for you.
Frequently Asked Questions about Kwin MCP
kwin-mcp is an MCP server that connects AI agents to KDE Plasma 6 Wayland through KWin. Its 29 tools can start virtual or connect to live sessions, launch applications, inspect the AT-SPI2 accessibility tree, capture screens, manage windows, inject mouse, keyboard, and touch input, use the clipboard, and access D-Bus.
Install it with `uv tool install kwin-mcp` or `pip install kwin-mcp`. KDE Plasma 6 on Wayland and Python 3.12 or newer are required. Isolated Python installation may also require a C compiler and development headers for PyGObject, Pycairo, and dbus-python.
Yes, the README names Cursor as an MCP client for kwin-mcp. Configure the server using Cursor's MCP setup with the documented command, such as `uvx kwin-mcp`, after installing the package and its system dependencies.
Yes, kwin-mcp can connect to an existing KWin session rather than creating only an isolated virtual session. It supports real KDE desktops and KWin instances inside containers, and live mode can be selected with session connection or made the default with `--default-live-session`.
No, kwin-mcp targets KDE Plasma 6 on Wayland and its virtual sessions do not require an X11 or physical display server. The documented use cases include headless Linux CI environments, provided the required KDE and KWin components are available.
Related MCP servers
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/kwin-mcp-2)HTML Embed
<a href="https://allmcps.com/mcp/kwin-mcp-2"><img src="https://allmcps.com/api/badge/kwin-mcp-2?style=directory" alt="Kwin MCP on AllMCPs" /></a>