# computer-use-mcp

> 💻 MCP server for Claude to control your computer

Latest version **2.0.0** (published 2026-11-19) · MIT license · 0 weekly downloads

## Install

```sh
npm install computer-use-mcp
pnpm add computer-use-mcp
yarn add computer-use-mcp
bun add computer-use-mcp
```

Provides the command `computer-use-mcp`.

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2026-11-19 |
| First published | 2025-02-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 30.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 400 |
| Author | Adam Jones |
| Maintainers | domdomegg |

## Links

- npm: https://www.npmjs.com/package/computer-use-mcp
- Repository: https://github.com/domdomegg/computer-use-mcp
- Homepage: https://github.com/domdomegg/computer-use-mcp#readme
- Issues: https://github.com/domdomegg/computer-use-mcp/issues
- npm.io page: https://npm.io/package/computer-use-mcp

## Dependencies (4)

- [zod](https://npm.io/package/zod.md) ^4.1.13
- [sharp](https://npm.io/package/sharp.md) ^0.35.3
- [@nut-tree-fork/nut-js](https://npm.io/package/@nut-tree-fork/nut-js.md) ^4.2.6
- [@modelcontextprotocol/sdk](https://npm.io/package/@modelcontextprotocol/sdk.md) ^1.24.3

## Recent versions

- 2.0.0 (latest) — 2026-11-19
- 1.8.0 — 2026-04-13
- 1.7.1 — 2026-03-18
- 1.7.0 — 2026-03-02
- 1.6.3 — 2026-02-11
- 1.6.2 — 2025-12-29
- 1.6.1 — 2025-12-28
- 1.6.0 — 2025-12-28
- 1.5.0 — 2025-12-14
- 1.4.0 — 2025-12-08
- 1.3.2 — 2025-12-08
- 1.3.1 — 2025-12-05
- 1.3.0 — 2025-12-05
- 1.2.0 — 2025-08-03
- 1.1.1 — 2025-07-30
- … 1 more at https://npm.io/package/computer-use-mcp/versions

## README

# computer-use-mcp

💻 A Model Context Protocol server for Claude to control your computer. This is very similar to [computer use](https://docs.anthropic.com/en/docs/build-with-claude/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](https://adamjones.me/install-mcp/?config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvbXB1dGVyLXVzZS1tY3AiXSwibmFtZSI6ImNvbXB1dGVyLXVzZSJ9), 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](https://platform.claude.com/docs/en/about-claude/models/overview).
- Use a small, common resolution - 720p works particularly well. On macOS, you can use [displayoverride-mac](https://github.com/domdomegg/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](https://chromewebstore.google.com/detail/rango/lnemjdnjjofijemhdogofbpcedhgcpmb). 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](https://docs.anthropic.com/en/docs/build-with-claude/computer-use), with some more nudging to prefer keyboard shortcuts.

This talks to your computer using [nut.js](https://github.com/nut-tree/nut.js)

## Contributing

Pull requests are welcomed on GitHub! To get started:

1. Install Git and Node.js
2. Clone the repository
3. Install dependencies with `npm install`
4. Run `npm run test` to run tests
5. Build with `npm run build`

## Releases

Versions follow the [semantic versioning spec](https://semver.org/).

To release:

1. Use `npm version <major | minor | patch>` to bump the version
2. Run `git push --follow-tags` to push with tags
3. Wait for GitHub Actions to publish to the NPM registry.

---
_Source: https://npm.io/package/computer-use-mcp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
