π Automation MCP
@ashwwwin
Control your Mac with detailed mouse, keyboard, screen, and window management capabilities.
Overview
What is π Automation MCP?
π Automation MCP is a Model Context Protocol (MCP) server that gives AI models complete desktop automation capabilities on macOS. It enables AI assistants to control the mouse, keyboard, take screenshots, manage windows, interact with UI elements, and analyze screen content.
How to use π Automation MCP?
Install via the furi tool with furi add ashwwwin/automation-mcp and then furi start automation-mcp. Alternatively, clone the repository, install dependencies with bun install, and start the server using bun run index.ts (HTTP transport) or bun run index.ts --stdio (stdio transport). On first run, grant Accessibility and Screen Recording permissions in macOS System Settings.
Key features of π Automation MCP
- Mouse control: click, move, scroll, drag, get position
- Keyboard input: type text, press key combinations, system shortcuts
- Screen capture and analysis: screenshots, color detection, image waiting
- Window management: list, focus, move, resize, minimize windows
- UI interaction via coordinates and screen highlight
- Cross-platform architecture with macOS support
Use cases of π Automation MCP
- Automate repetitive desktop tasks via AI assistant
- Perform UI testing and visual regression checks
- Enable AI to navigate and control any application
- Capture and analyze screen content in real time
- Orchestrate complex multiβstep workflows across apps
FAQ from π Automation MCP
What permissions does π Automation MCP require?
On macOS, you must grant Accessibility (for mouse and keyboard control) and Screen Recording (for screenshots and analysis) permissions in System Settings.
What runtime does π Automation MCP need?
The server requires the Bun runtime. Quick install: curl -fsSL https://bun.sh/install | bash.
Can I install π Automation MCP without furi?
Yes. Clone the repository, run bun install, then start the server with bun run index.ts (HTTP) or bun run index.ts --stdio (stdio).
Which operating systems are supported?
The server is primarily designed for macOS. Its architecture mentions crossβplatform support (Windows/Linux) via nut.js and fallback systems, but full functionality is documented for macOS.
How does π Automation MCP handle security?
It runs locally only (no network access), requires explicit permission grants, logs all actions, and can be limited to specific applications.