Control your Mac with detailed mouse, keyboard, screen, and window management capabilities.
Automation MCP is a Model Context Protocol (MCP) server that provides AI models with complete desktop automation capabilities on macOS. It enables AI assistants to:
Make sure you have furi installed, and then run the following command:
furi add ashwwwin/automation-mcp
followed by:
furi start ashwwwin/automation-mcp
and you're done! (or you can just use the furi desktop app for no cli).
curl -fsSL https://bun.sh/install | bash
git clone https://github.com/ashwwwin/automation-mcp.git
cd automation-mcp
bun install
# Start with HTTP transport (recommended for web apps)
bun run index.ts
# Or start with stdio transport (for command line tools)
bun run index.ts --stdio
On first run, macOS will ask for permissions. You must grant these for full functionality:
Or manually enable in: System Settings โ Privacy & Security โ Accessibility/Screen Recording
mouseClick
- Click at coordinates with left/right/middle buttonmouseDoubleClick
- Double-click at coordinatesmouseMove
- Move cursor to positionmouseGetPosition
- Get current cursor locationmouseScroll
- Scroll in any directionmouseDrag
- Drag from current position to targetmouseButtonControl
- Press/release mouse buttonsmouseMovePath
- Follow a smooth path with multiple pointstype
- Type text or press key combinationskeyControl
- Advanced key press/release controlsystemCommand
- Common shortcuts (copy, paste, undo, save, etc.)screenshot
- Capture full screen, regions, or specific windowsscreenInfo
- Get screen dimensionsscreenHighlight
- Highlight screen regions visuallycolorAt
- Get color of any pixelwaitForImage
- Wait for images to appear (template matching)getWindows
- List all open windowsgetActiveWindow
- Get current active windowwindowControl
- Focus, move, resize, minimize windowsAccessibility - Required for:
Screen Recording - Required for:
If you've already configured furi with Claude Desktop, you don't need to do anything.
Add to your MCP configuration:
{
"mcpServers": {
"furi": {
"command": "furi",
"args": ["connect"]
}
}
}
Add to your MCP configuration:
{
"mcpServers": {
"automation": {
"command": "bun",
"args": ["run", "/path/to/automation-mcp/index.ts", "--stdio"]
}
}
}
Permission Denied Errors
xcode-select --install
Having issues? Check the troubleshooting section above or open an issue with:
{ "mcpServers": { "automation-mcp": { "command": "bun", "args": [ "run", "/path/to/automation-mcp/index.ts", "--stdio" ] } } }
Related projects feature coming soon
Will recommend related projects based on sub-categories