Home

lowlevel-computer-use-mcp

A low-level computer-use MCP server for Windows and Linux. It exposes raw desktop control to any MCP client — Claude Code, Codex, Claude Desktop, etc. — as 53 tools.

⚠️ This server performs real, unsandboxed actions on the host machine — clicking, typing, killing processes, and running shell/elevated/Linux commands with your user's privileges. Only register it where that is acceptable.

What it can do

• 🖱️ Mouse — move, click, double/right/middle click, drag, scroll, cursor position
• ⌨️ Keyboard — type text, press hotkey combinations
• 🖥️ Shell — run arbitrary commands and capture stdout/stderr/exit code
• 🪟 Windows — list, move, resize, focus, minimize, maximize, restore, close, show/hide
• ⚙️ Processes — list running processes; kill by PID or name
• 📸 Screenshots — all monitors, one monitor, a region, or a single window (PrintWindow)
• ✂️ Cropping — crop any saved image to a sub-region
• 🎥 Recording — record a monitor or region to mp4 in the background
• 🎯 Background / unfocused targeting — drive a window via Win32/X11 messages without focusing it
• 🫥 Headless-with-GUI — Windows off-screen desktop / Linux Xvfb
• 👁️ Show-for-login — bring a hidden app/desktop forward for a manual login, then hide it
• 🟢 AutoHotkey — run AHK scripts; ControlSend/ControlClick for reliable background input
• 🌀 Ephemeral WSL — spin up a throwaway Linux distro on demand, run commands, tear it down
• 🐧 Cross-platform — the same tools work natively on Linux (X11 + Xvfb)
• 🛡️ Run-as-admin — per-command UAC elevation or whole-server elevation
• 🚀 Auto-start on boot — register a logon scheduled task
• 🧩 GUI installer — one window that installs everything automatically

Start here

• Installation — install, the GUI auto-installer, and prerequisites
• Registering Clients — Claude Code, Codex, and YOLO (no-prompt) mode
• Tool Reference — every one of the 53 tools, with parameters
• Workflows — copy-adaptable end-to-end recipes

Deep dives

• Background Targeting — control a window without stealing focus
• Headless GUI — run apps invisibly (Windows desktop / Linux Xvfb)
• Linux Support — native X11 automation
• WSL — ephemeral Linux boxes on a Windows host
• AutoHotkey — the AHK add-in
• Run as Admin and Boot Startup
• Macros — save repeated UI sequences as reusable skills
• Architecture — how it's built
• Troubleshooting

Repository

Source: https://github.com/codingmachineedge/lowlevel-computer-use-mcp