Capture a screenshot of the full screen (or the active window if active_window=true). Saves a PNG under /tmp/claude-linux-mcp/shots/ and returns the path.

List all visible windows with id, pid, desktop, geometry (x/y/width/height), hostname, and title.

Bring a window matching the given title pattern (substring, case-insensitive per wmctrl) to the foreground.

Move and/or resize a window matching the given title pattern. Any of x, y, width, height omitted leaves that dimension unchanged.

Request a window matching the given title pattern to close (gracefully, via the WM close hint).

Move the mouse pointer to absolute screen coordinates (x, y).

Click a mouse button. If x and y are provided, the pointer moves there first; otherwise clicks at the current pointer location.

Drag from (x1, y1) to (x2, y2) while holding the given button (default left).

Scroll in a direction (up/down/left/right) by N clicks (default 3).

Type a string into the currently-focused window (emits keystrokes). Use key_press for special/modifier combos.

Press a keyboard combination using xdotool's keysym notation. Examples: 'ctrl+c', 'alt+Tab', 'super', 'Return', 'Escape', 'Page_Down'.

Read the current X11 CLIPBOARD selection as text.

Write a string to the X11 CLIPBOARD selection.

Launch an application via a shell command (e.g. "firefox", "gnome-terminal", "code /path/to/project"). The process is detached from this server.

Take a screenshot and OCR it with tesseract. Returns the recognized text plus the path to the underlying PNG. Use when Claude needs to READ what is on screen (log windows, error dialogs, terminal output in non-focused windows) rather than just see the image. Requires tesseract-ocr installed.