mcp-control

MCP server that gives Claude Code full mouse, keyboard, and app control on macOS. Tell Claude what to do and watch it operate your computer.

Pair with mcp-screen for vision + control.

Setup

Add to ~/.claude/settings.json:

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

Restart Claude Code. Done.

Related MCP server: device-controller-mcp

Usage

Just tell Claude what to do:

• "Open Safari and go to github.com"

• "Click the search box and type my query"

• "Fill in this form - name is Andre, email is..."

• "Switch to Slack and send a message"

• "Scroll down on this page"

Tools

Mouse

Keyboard

App Control

Batch

The run_actions tool is the key for speed. Instead of one tool call per action (each with Claude think time), it batches everything into a single round-trip.

How It Works

Uses macOS Core Graphics events via JXA (JavaScript for Automation) and AppleScript. Zero external dependencies - just built-in macOS tools.

• Mouse control: CGEvent API (sub-millisecond)

• Keyboard: AppleScript keystroke (handles Unicode)

• Key combos: CGEvent with modifier flags

• App control: AppleScript

Permissions

Your terminal needs Accessibility permission:

System Settings > Privacy & Security > Accessibility - enable your terminal app.

Requirements

• macOS

• Node.js >= 18

Author

@voidmode

License

MIT