# PySide6 MCP

> PySide6 MCP is an open-source MCP server for developer tools. Let an AI assistant screenshot, inspect and click through a running PySide6 desktop app. It runs locally on your machine and is started by your AI client.

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

## About

The server works like Playwright for Qt: the assistant launches your PySide6 app, takes screenshots, reads the widget tree, clicks, types and reads Python logs, all without adding anything to the app's source. `launch_app` injects a small HTTP bridge through an isolated `PYTHONPATH` and picks an ephemeral localhost port, so neither `pyproject.toml` nor the app's environment is touched. The README contrasts this with qt-mcp, which needs the package in the target app and a probe variable.

Tools go beyond clicking. `trigger_action` fires a QAction without opening menus, `get_app_status` detects likely modal blocks, and `eval_python` runs code inside the app process. `launch_app` returns only once a visible window has been quiet for 500 ms.

It needs Python 3.11+, PySide6 6.6+ and uv, was tested on Windows, and is expected to work on Linux and macOS. A companion Agent Skill ships with the Claude Code plugin.

## Features

- **Launch without code changes:** `launch_app` starts the app with an injected bridge and waits for UI readiness.
- **Screenshots:** Capture a window or one widget, aware of modal dialogs.
- **Widget tree inspection:** Read class, name, geometry, text and state for any widget.
- **Input simulation:** Click, double-click, type, press keys and scroll.
- **QAction triggering:** List and trigger menu and toolbar actions directly.
- **Logs and in-app Python:** Read Python logs and app output, or run code in the app process.

## Good for

- Ask an assistant to click Apply and report what changed
- Find out why a checkbox is disabled
- Fill in and submit a form for a smoke test
- Pull recent logs from a running desktop app
- Debug a modal dialog that blocks the UI

## Install

### Claude Code (Terminal)

```sh
claude mcp add pyside6-mcp -- uvx pyside6-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pyside6-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
```

## Tools

- `launch_app`: Launch the app and wait for UI readiness
- `list_apps`: Pids of apps launched by this server
- `get_launch_help`: How to set cwd, script and app_args
- `wait_until_ready`: Wait for UI readiness on a running app
- `wait_for_idle`: Wait until the UI is quiet after an action
- `get_app_status`: Process and bridge health
- `stop_app`: Stop a launched app
- `screenshot`: Capture a window or widget
- `get_widget_tree`: Full widget hierarchy with IDs
- `get_widget_info`: Properties of one widget
- `get_app_state`: Active window, focus and screen info
- `find_widget`: Search widgets by class, name or text
- `click`: Mouse click
- `double_click`: Double click
- `type_text`: Keyboard input
- `press_key`: Press a named key
- `scroll`: Scroll wheel
- `list_actions`: List QAction items
- `trigger_action`: Trigger a QAction
- `get_logs`: Recent Python log records
- `get_app_output`: Raw stdout and stderr
- `eval_python`: Execute Python inside the app process

## FAQ

### Do I need to change my app?

No. launch_app injects the bridge at launch; you only need PySide6 6.6+ in the app's own environment.

### Which operating systems work?

Windows was tested; Linux and macOS should work.

### What does it need installed?

Python 3.11+ and uv; the MCP server runs through uvx.

### Can it run in an app that is already running?

Yes, by starting the bridge yourself with python -m pyside6_mcp or install_bridge(), then calling wait_until_ready.

### Is PySide6 MCP free?

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

### How do I add PySide6 MCP to Claude Code?

Run this command in your terminal: claude mcp add pyside6-mcp -- uvx pyside6-mcp

### What are the best alternatives to PySide6 MCP?

The closest alternatives to PySide6 MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

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