A
licenseNot graded
qualityD
maintenanceEnables AI agents to see and control your desktop with tools for screenshots, clicks, typing, and more, all locally on macOS and Windows.
210 npm
MIT
localScreenControl
by Akicou
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
localScreenControl
An MCP server that lets an AI assistant see and control your local desktop.
Tool | What it does |
| Screenshot of a monitor (1 = primary, 0 = all), downscaled to |
| Click at a pixel of the last screenshot ( |
| Mouse wheel at a point (negative = down) |
| Key combos like |
| Enter text in the focused field, via clipboard paste (default) or real keystrokes |
| Read / write clipboard text ( |
| Wait until the screen stops changing (page loads, dialogs, animations) |
| Run many actions in one call, then return a screenshot |
batch example:
[{"action": "click", "x": 700, "y": 140},
{"action": "type", "text": "Hello"},
{"action": "keys", "keys": "enter"},
{"action": "settle"},
{"action": "wait", "ms": 300}]Works on Windows and Linux (X11). Requires Python 3.10+.
Setup
Windows (PowerShell)
git clone https://github.com/Akicou/localScreenControl
cd localScreenControl
powershell -ExecutionPolicy Bypass -File .\setup.ps1Linux
git clone https://github.com/Akicou/localScreenControl
cd localScreenControl
./setup.shThe script creates a .venv, installs dependencies, registers the server with
Claude Code (if claude is on your PATH) and prints a JSON config snippet for
other MCP clients such as Claude Desktop.
Related MCP server: screenmcp-claude-plugin
Notes
Coordinates are pixels of the most recent screenshot image. The server maps them back to the real screen (downscaling, DPI, monitor offset), so they always match what the AI saw.
Linux clipboard needs
xcliporxsel(sudo apt install xclip).Self-check:
.venv/bin/python test_server.py(or.venv\Scripts\python test_server.py).Linux on Wayland: only X11/XWayland windows can be captured/controlled. Use an X11 session for full control.
Key names follow pynput's
Key(ctrl,shift,alt,cmd/win,tab,enter,esc,f1–f20,up,page_down, ...).
Security
This server gives the connected AI full control over your mouse and keyboard. Only connect it to clients you trust.
License
MIT
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues
Related MCP Connectors
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Give your AI hands on every computer you own. Remote control of your Windows, Mac and Linux machines from one ChatGPT, Claude or Cursor chat — even from your phone. Ask it to find out why the office server is crawling, update every PC in the house, sort out your mom's laptop from another city, or ship the site from your work machine while you're on a train. It runs commands, reads files and takes a screenshot when it needs to see the screen. You decide what each computer allows, and you can cut any of them off in a second.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to control the local desktop via screenshot, mouse, keyboard, and clipboard operations.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to observe and control the user's live desktop by listing apps, reading accessibility trees, and performing clicks, typing, scrolling, dragging, and other input actions with per-action approvals and local audit archives.1MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to see and operate a Windows PC through mouse, keyboard, screenshots, OCR, window control, and shell commands.-