winapp-mcp-winui

What problem does it solve?

This Skill eliminates flaky, slow, and unreliable Windows UI automation by guiding stable WinUI and desktop interactions through consistent WinApp MCP workflows, including virtualization, dialogs, and async UI updates.

Core Features & Use Cases

• Session lifecycle management: Launch, attach, snapshot, and close Windows apps while tracking the correct appId.
• Stable element targeting: Prefer automationId over localized name, use snapshots strategically, and invalidate caches after out-of-band UI changes.
• Robust interaction & verification: Use the right patterns and waits (wait_for_input_idle, wait_for_element, wait_for_condition, invoke_element) plus assertions via read_element/get_all_values.
• E2E regression support: Capture and compare visual evidence with screenshots and diffs, and detect tree changes via hashes.
• Edge-case handling for real WinUI apps: Scroll/realize virtualized items, find items in large lists, operate on separate windows (dialogs/file pickers), and debug async structure/property changes with event monitoring.

Quick Start

Use the winapp-mcp-winui skill to launch or attach to the ChurchPresenter Windows app, wait for the target screen, interact using AutomationId-based selectors, and then verify results with read_element and visual screenshots.