servo-mcp

A desktop MCP server that gives AI agents the ability to see and control your desktop.

servo-mcp.com - Installation instructions and documentation

What is Servo?

Servo is an MCP (Model Context Protocol) server that enables Claude Code and other AI agents to:

• Take screenshots of your screen

• Click buttons and interact with UI elements

• Type text and press keyboard shortcuts

• Scroll and navigate applications

• Verify that changes actually work

Key features:

• 100% local - no cloud, no telemetry, no data sharing

• Works on macOS and Windows

• Pure Node.js with native platform APIs (no Electron, no external dependencies)

• Simple npm install

Related MCP server: ComputerMate

Installation

Install via npm (macOS and Windows):

npm install -g servo-mcp
npx servo-mcp --setup

macOS Permissions

Grant permissions to your terminal app (Terminal, iTerm, VS Code, Cursor, etc.) in System Settings > Privacy & Security:

• Accessibility - for mouse clicks and keyboard input

• Screen Recording - for taking screenshots

Child processes like servo-mcp inherit permissions from the parent terminal app.

Windows

No special permissions required. Windows may prompt for access when servo-mcp runs.

Setup with Claude Code

After running npx servo-mcp --setup, your ~/.claude.json will be configured:

{
  "mcpServers": {
    "servo": {
      "command": "npx",
      "args": ["servo-mcp"]
    }
  }
}

Restart Claude Code and test with: "take a screenshot"

Available Tools

Development

pnpm install
pnpm dev:mcp          # Run MCP server in dev mode
pnpm dev:web          # Run website

# Build
pnpm build:mcp        # Bundle with esbuild

Architecture

Servo is a pure Node.js MCP server that uses:

• Native platform APIs for automation (no Electron)

• macOS: screencapture, AppleScript, Python/Quartz

• Windows: PowerShell, .NET, user32.dll

Links

• Website: servo-mcp.com

• npm: npmjs.com/package/servo-mcp

• GitHub: github.com/d11r/servo-mcp

License

MIT License

Author

Created by Dragos Strugar