PySide6 MCP
Let an AI assistant screenshot, inspect and click through a running PySide6 desktop app
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pyside6-mcp": {
"command": "uvx",
"args": [
"pyside6-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pyside6-mcp": {
"command": "uvx",
"args": [
"pyside6-mcp"
]
}
}
}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.


