Claude KVM
MCP server — control remote desktops via VNC with a native Swift daemon and Apple Vision OCR
What is Claude KVM?
Claude KVM is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server — control remote desktops via vnc with a native swift daemon and apple vision ocr
MCP server — control remote desktops via VNC with a native Swift daemon and Apple Vision OCR
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server — control remote desktops via VNC with a native S
Use Cases
Maintainer
Works with
Installation
NPM
npx -y claude-kvmManual Installation
npx -y claude-kvmConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude KVM
Claude KVM is an MCP server that enables Claude and other AI agents to control remote desktops via VNC, using a native Swift daemon on macOS with Apple Vision framework for OCR-based element detection. It exposes a comprehensive set of tools covering screenshots, mouse actions (click, drag, scroll, hover), keyboard input (tap, combo, type, paste), OCR-based element detection with bounding boxes, and system utilities like health checks and baseline diffing. Teams building computer-use agents, automation pipelines, or AI-driven QA workflows use it to give Claude eyes and hands on remote macOS or Linux desktops.
Prerequisites
- macOS with Apple Silicon (the native daemon requires aarch64/arm64)
- Homebrew installed for the daemon setup
- Node.js LTS for the npx MCP server component
- A VNC-enabled remote desktop (macOS Screen Sharing, Linux VNC server, etc.) with host, port, username, and password
- An MCP-compatible client such as Claude Desktop or Claude Code
Install the native Swift daemon via Homebrew
The Claude KVM daemon handles VNC connections and Apple Vision OCR. Install it from the ARAS-Workspace tap.
brew tap ARAS-Workspace/tap
brew install claude-kvm-daemonVerify the daemon binary path
Note the daemon installation path for use in the MCP configuration.
which claude-kvm-daemon
# Typically: /opt/homebrew/bin/claude-kvm-daemonConfigure your VNC target
Gather the VNC connection details for the remote desktop you want to control: host IP, port (default 5900), username, and password.
Add the MCP server to your client configuration
Create or update your .mcp.json file with the claude-kvm entry, pointing to the daemon binary and your VNC credentials.
Test the connection with a screenshot
Ask your AI assistant to take a screenshot of the remote desktop to confirm the VNC connection is working.
Claude KVM Examples
Client configuration
MCP configuration for Claude KVM with VNC connection details and daemon path.
{
"mcpServers": {
"claude-kvm": {
"command": "npx",
"args": ["-y", "claude-kvm"],
"env": {
"VNC_HOST": "192.168.1.100",
"VNC_PORT": "5900",
"VNC_USERNAME": "user",
"VNC_PASSWORD": "your-vnc-password",
"CLAUDE_KVM_DAEMON_PATH": "/opt/homebrew/bin/claude-kvm-daemon",
"CLAUDE_KVM_DAEMON_PARAMETERS": "-v"
}
}
}
}Prompts to try
Example prompts for controlling a remote desktop through Claude KVM.
- "Take a screenshot of the remote desktop and describe what you see"
- "Click the Safari icon in the dock on the remote Mac"
- "Type 'hello world' into the currently focused text field"
- "Detect all buttons and text fields visible on screen"
- "Scroll down in the active window and take a screenshot after"Troubleshooting Claude KVM
VNC connection refused or times out
Verify the remote machine has VNC/Screen Sharing enabled. On macOS, go to System Settings → General → Sharing and enable Screen Sharing. Confirm VNC_HOST and VNC_PORT match the actual server address and that firewall rules allow port 5900.
claude-kvm-daemon not found at the configured path
Run 'which claude-kvm-daemon' in Terminal to find the actual installation path. Update CLAUDE_KVM_DAEMON_PATH in your MCP config to match. On Apple Silicon Macs the typical path is /opt/homebrew/bin/claude-kvm-daemon.
OCR / detect_elements returns no results
The Apple Vision OCR requires macOS 12 or later. Ensure the daemon has Accessibility permissions: go to System Settings → Privacy & Security → Accessibility and add the terminal or Claude app that launches the daemon.
Frequently Asked Questions about Claude KVM
What is Claude KVM?
Claude KVM is a Model Context Protocol (MCP) server that mcp server — control remote desktops via vnc with a native swift daemon and apple vision ocr It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude KVM?
Install via npm with the command: npx -y claude-kvm. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Claude KVM?
Claude KVM works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude KVM free to use?
Yes, Claude KVM is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Claude KVM Alternatives — Similar Browser Automation Servers
Looking for alternatives to Claude KVM? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Claude KVM in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Claude KVM?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.