# oriel-vnc

> oriel-vnc is an open-source MCP server for browser automation. MCP server that lets an assistant operate any VNC-reachable desktop by screenshot. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://yordilorenzo.github.io/oriel/
- **Repository:** https://github.com/yordilorenzo/oriel/tree/HEAD/vnc
- **MCP Registry name:** io.github.YordiLorenzo/oriel-vnc
- **Categories:** browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

Where its Windows sibling reads window controls as text, this server works from pixels. It suits Macs, Linux machines and screens with no accessibility tree, such as games, remote desktops and canvases. It runs on the computer where the assistant runs and connects out to each machine's VNC server, so nothing is installed on the targets.

Machines are listed in a hosts file (default ~/.config/oriel-vnc/hosts.json) with an address and credentials that can be literal, read from an environment variable, or fetched by a command such as a password manager CLI. Every coordinate refers to the latest full screenshot of that machine, and the server scales it to the real screen.

The docs advise allowing VNC only from your own network or tailnet.

## Features

- **Screenshot capture:** Returns the full screen scaled to at most 1456 px on the long edge.
- **Zoom on a region:** Fetches a region at full resolution to read small text.
- **Mouse control:** Click, move, drag and scroll at given coordinates.
- **Keyboard input:** Type text or send keys and combinations such as cmd+space.
- **Multiple machines:** Several VNC hosts can be configured and addressed by name.

## Good for

- Drive a Mac or Linux desktop from an AI assistant
- Operate a remote desktop that offers no accessibility tree
- Click through an app or game that only exposes pixels
- Check a second machine on your network from one session

## Install

### Claude Code (Terminal)

```sh
claude mcp add oriel-vnc -- uvx oriel-vnc
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oriel-vnc": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
```

## Tools

- `vnc_screenshot`: The whole screen, scaled so its long edge is at most 1456 px.
- `vnc_zoom`: A region at full resolution, for small text.
- `vnc_click`: Click at x,y with left, right or middle button, or double-click.
- `vnc_move`: Move the pointer for hover menus and tooltips.
- `vnc_drag`: Press, move in steps and release.
- `vnc_scroll`: Wheel clicks at x,y in any direction.
- `vnc_type`: Type text into the focused field.
- `vnc_key`: Send a key or combination such as enter or ctrl+alt+t.

## FAQ

### Do I install anything on the target machine?

No. It only needs a VNC server running, such as Screen Sharing on macOS, TigerVNC or x11vnc on Linux, or TightVNC on Windows.

### Where do the credentials go?

In the hosts file, as plain values, environment variables or command output.

### Should I use it for Windows apps?

The README points Windows apps to the oriel.exe server, which reads windows as text.

### Is oriel-vnc free?

Yes. oriel-vnc is open source, so you can use and self-host it for free.

### How do I add oriel-vnc to Claude Code?

Run this command in your terminal: claude mcp add oriel-vnc -- uvx oriel-vnc

### What are the best alternatives to oriel-vnc?

The closest alternatives to oriel-vnc are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/oriel-vnc
