Summary
Gives Claude direct control over your computer through screen capture, mouse clicks, and keyboard input using the nut.js automation library. You can ask it to change desktop backgrounds, navigate websites, fill forms, or interact with any GUI application. Works across Claude Desktop, Cursor, and Cline with simple npx installation. The creator rightfully warns this is like giving a toddler your computer since models make mistakes and are vulnerable to prompt injection. Best used with small resolutions like 720p and the Rango browser extension for more reliable keyboard navigation over coordinate clicking.
Install to Claude Code
verifiedclaude mcp add computer-use-mcp -- npx -y computer-use-mcpRun in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Verified live against the running server on Jun 11, 2026.
verified live1 tools
computerUse a mouse and keyboard to interact with a computer, and take screenshots. * This is an interface to a desktop GUI. You do not have access to a terminal or applications menu. You must click on desktop icons to start applications. * Always prefer using keyboard shortcuts rathe...3 params
Use a mouse and keyboard to interact with a computer, and take screenshots. * This is an interface to a desktop GUI. You do not have access to a terminal or applications menu. You must click on desktop icons to start applications. * Always prefer using keyboard shortcuts rathe...
Parameters* required
textstringText to type or key command to execute
action*stringThe action to perform. The available actions are:
* key: Press a key or key-combination on the keyboard.
* type: Type a string of text on the keyboard.
* get_cursor_position: Get the current (x, y) pixel coordinate of the cursor on the screen.
* mouse_move: Move the cursor to a specified (x, y) pixel coordinate on the screen.
* left_click: Click the left mouse button. If coordinate is provided, moves to that position first.
* left_click_drag: Click and drag the cursor to a specified (x, y) pixel coordinate on the screen.
* right_click: Click the right mouse button. If coordinate is provided, moves to that position first.
* middle_click: Click the middle mouse button. If coordinate is provided, moves to that position first.
* double_click: Double-click the left mouse button. If coordinate is provided, moves to that position first.
* scroll: Scroll the screen in a specified direction. Requires coordinate (moves there first) and text parameter with direction: "up", "down", "left", or "right". Optionally append ":N" to scroll N pixels (default 300), e.g. "down:500".
* get_screenshot: Take a screenshot of the screen.one of
key · type · mouse_move · left_click · left_click_drag · right_clickcoordinatearray(x, y): The x (pixels from the left edge) and y (pixels from the top edge) coordinates
computer-use-mcp
💻 A Model Context Protocol server for Claude to control your computer. This is very similar to computer use, but easy to set up and use locally.
Here's Claude Haiku 4.5 changing my desktop background (4x speed):
https://github.com/user-attachments/assets/cd0bc190-52c4-49db-b3bc-4b8a74544789
[!WARNING] At time of writing, models make frequent mistakes and are vulnerable to prompt injections. As this MCP server gives the model complete control of your computer, this could do a lot of damage. You should therefore treat this like giving a hyperactive toddler access to your computer - you probably want to supervise it closely, and consider only doing this in a sandboxed user account.
Installation
Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).
Tips
This should just work out of the box.
However, to get best results:
- Use a model good at computer use - I recommend the latest Claude models.
- Use a small, common resolution - 720p works particularly well. On macOS, you can use displayoverride-mac to do this. If you can't use a different resolution, try zooming in to active windows.
- Install and enable the Rango browser extension. This enables keyboard navigation for websites, which is far more reliable than Claude trying to click coordinates. You can bump up the font size setting in Rango to make the hints more visible.
How it works
We implement a near identical computer use tool to Anthropic's official computer use guide, with some more nudging to prefer keyboard shortcuts.
This talks to your computer using nut.js
Contributing
Pull requests are welcomed on GitHub! To get started:
- Install Git and Node.js
- Clone the repository
- Install dependencies with
npm install - Run
npm run testto run tests - Build with
npm run build
Releases
Versions follow the semantic versioning spec.
To release:
- Use
npm version <major | minor | patch>to bump the version - Run
git push --follow-tagsto push with tags - Wait for GitHub Actions to publish to the NPM registry.
Featured
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Capacitor makes coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Packagecomputer-use-mcp
TransportSTDIO
Tools verifiedJun 11, 2026
UpdatedApr 13, 2026
