Skip to content
MCP server

oriel-vnc

MCP server that lets an assistant operate any VNC-reachable desktop by screenshot

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About oriel-vnc

oriel-vnc is an open-source MCP server for browser automation. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add oriel-vnc -- uvx oriel-vnc

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oriel-vnc": {
      "command": "uvx",
      "args": [
        "oriel-vnc"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ORIEL_VNC_HOSTSPath to the hosts file that lists each machine's VNC address and login. Default: ~/.config/oriel-vnc/hosts.json

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free; the project site lists the Windows server as Apache-2.0

Prices change. Check yordilorenzo.github.io before you buy.

oriel-vnc 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 to oriel-vnc

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Browser Use

    MCP server

    Browser agents and cloud browsers for AI, with an MCP server for web tasks

    • 7 tools
    • Remote
    • Freemium
    • 121K GitHub stars
    • Browser automation
  3. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  4. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  5. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  6. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools