oriel-vnc
MCP server that lets an assistant operate any VNC-reachable desktop by screenshot
- 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-vncAdd to claude_desktop_config.json
{
"mcpServers": {
"oriel-vnc": {
"command": "uvx",
"args": [
"oriel-vnc"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"oriel-vnc": {
"command": "uvx",
"args": [
"oriel-vnc"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Browser Use
MCP serverBrowser agents and cloud browsers for AI, with an MCP server for web tasks
- 7 tools
- Remote
- Freemium
- 121K GitHub stars
- Browser automation

Scrapling MCP Server
MCP serverMCP 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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools