Skip to content
MCP server

PySide6 MCP

Let an AI assistant screenshot, inspect and click through a running PySide6 desktop app

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Windows, Linux
Runs
Locally
Version
0.1.1
Listing updated
today

Similar MCP servers

About PySide6 MCP

PySide6 MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add pyside6-mcp -- uvx pyside6-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pyside6-mcp": {
      "command": "uvx",
      "args": [
        "pyside6-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (22)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free package on PyPI; licence not published.

PySide6 MCP 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.

How AIPoweredBot checks servers