# clawdcursor

Lets an agent drive the desktop: turns the screen into a UI map and clicks elements by stable id. Useful when the app has no API but the task still has to get done.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 406
- Author: AmrDab
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AmrDab/clawdcursor
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/clawdcursor

## What it does

clawdcursor sits between your agent and the operating system. It reads the screen through the accessibility tree, builds a map of the interface, and acts on elements by their identifiers. Screenshots and vision come last, only when the markup can't be read.

Every action is checked afterwards, and the result goes back to the agent. One safety checkpoint gates the whole flow. If a sign-in, a 2FA code or an upgrade page blocks the way, the run pauses: the screen edge turns blue, the agent asks you for that single step, then carries on from where it stopped.

You need Node.js 20 or newer. On macOS, refusing screen-recording permission breaks only screenshots and OCR — windows and keystrokes keep working. Windows, macOS and Linux are all supported, so test on the system where the target app actually runs.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add clawdcursor -- npx -y clawdcursor
```

### Codex

**Platform CLI**
```bash
codex mcp add clawdcursor -- npx -y clawdcursor
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "clawdcursor": {
            "command": "npx",
            "args": [
                "-y",
                "clawdcursor"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "clawdcursor": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "clawdcursor"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add clawdcursor npx -y clawdcursor
```

## When to use it
- run an operation in an app that has no public API
- fill a desktop form field by its name
- pause the agent at a login and hand that step to a person
- confirm the expected result showed up after a click
- read a page's text without touching the clipboard

## Example prompts
- Open the app, find the field called User code and type the value from the email
- Fill in the form, but stop at the sign-in screen and ask me to log in
- Copy the full text of the open document and summarise it

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md