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.

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