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.
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
| Tool | Description | |------|-------------| | mouse_move | Move cursor to (x, y) | | mouse_click | Click at (x, y) with left/right, single/double/triple | | mouse_drag | Drag from one point to another | | mouse_scroll | Scroll up/down/left/right | | get_cursor_position | Get current cursor coordinates |
Keyboard
| Tool | Description | |------|-------------| | type_text | Type a string into the focused field | | press_key | Press a key combo (e.g. cmd+c, tab, enter) |
App Control
| Tool | Description | |------|-------------| | get_frontmost_app | Get focused app name and bundle ID | | focus_app | Bring an app to the front | | list_windows | List all visible windows with positions and sizes |
Batch
| Tool | Description | |------|-------------| | run_actions | Execute a sequence of actions in one call - click, type, press keys, switch apps |
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
License
MIT
