by ashwwwin
Control your Mac with detailed mouse, keyboard, screen, and window management capabilities.
# Add to your Claude Code skills
git clone https://github.com/ashwwwin/automation-mcpAutomation 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 | bashgit 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
No comments yet. Be the first to share your thoughts!
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 --installHaving issues? Check the troubleshooting section above or open an issue with: