Repository navigation
winuse-mcp now uses the tool and argument names of Anthropic's computer use toolset, computer_toolset_20260801, and adds the four actions it was missing.
Breaking: argument names changed
Every tool that takes a position now uses Anthropic's argument names. Clients that read the tool schemas at startup, which includes Claude Code, pick this up on their own. Scripts that call the tools by argument name need updating:
| Tool | v0.1.x | v0.2.0 |
|---|---|---|
left_click, double_click, triple_click, right_click, middle_click, mouse_move |
x, y |
coordinate: [x, y] |
left_click_drag |
start_x, start_y, end_x, end_y |
start_coordinate, coordinate |
scroll |
x, y, direction, amount |
scroll_direction, scroll_amount, coordinate |
key |
combo |
text |
wait |
seconds |
duration |
cursor_position result |
(x, y) |
X=x, Y=y |
Added
zoom(region): captures[x0, y0, x1, y1]at full resolution for text too small to read in a screenshot.hold_key(text, duration): holds a key or chord for up to 10s. Parking the mouse at the top-left pixel releases it early. A shifted character is named by its base key:shift+=, not+.left_mouse_down()andleft_mouse_up(): press and release at the cursor, for dragsleft_click_dragcannot express.texton clicks, drags and scrolls: modifier keys held for that one action, such asshiftorctrl+shift.coordinateis optional on clicks and scrolls; leaving it out acts at the cursor.keytakesrepeat, 1 to 100.
Differences from Anthropic's toolset
record is extra. wait and hold_key stop at 10s where Anthropic allows 300s, and scroll_amount stops at 20. Only the primary monitor is captured; the current toolset has no monitor selection either.
Also in this release
- The README points Claude Desktop users on Windows to the built-in computer use feature, and lists where winuse fits: the Claude Code CLI on Windows, plans and providers the built-in feature excludes, and other MCP clients.
- Headless pytest unit tests, run in CI, with mss, pyautogui and pyperclip stubbed.
pyproject.tomlversion is 0.2.0. It said 0.1.0 through v0.1.1.
Install
claude mcp add --scope user winuse -- uvx --from git+https://github.com/ryanportfolio/winuse-mcp@v0.2.0 winuse-mcp