MacPilot CLI

What is MacPilot CLI?

MacPilot CLI is an open-source tool that enables Large Language Models (LLMs) to interact with macOS through the MCP (Model Control Protocol) protocol. It provides a collection of system tools for AI assistants to perform various operations on macOS.

How to use MacPilot CLI?

Download the binary from the Releases page, configure your MCP-compatible application (Cursor or Claude Desktop) with the path to the binary, and grant the necessary screen recording and accessibility permissions. The binary is invoked directly as a command in the MCP server configuration.

Key features of MacPilot CLI

• Provides system tools for macOS interaction via MCP
• Includes tools for cursor control, mouse, and paste
• Enables screen capture and shell command execution
• Supports opening and listing applications
• Retrieves window information and accessibility data
• Designed for LLM-powered AI assistants

Use cases of MacPilot CLI

• AI assistants controlling macOS applications and system settings
• Automating repetitive tasks like clicking, typing, and pasting
• Debugging or inspecting app windows and accessibility elements
• Capturing screenshots for visual analysis or documentation
• Running shell commands through natural language prompts

FAQ from MacPilot CLI

What macOS versions does MacPilot CLI support?

It requires macOS 14.0 (Sonoma) or later on a Mac with Apple Silicon.

How do I install MacPilot CLI?

Download the binary from the GitHub Releases page, then add its path to your MCP-compatible application's configuration.

What permissions are needed?

The application using MacPilot CLI (e.g., Cursor) needs screen recording and accessibility permissions in System Settings.

Which LLM applications can I use with MacPilot CLI?

It works with any MCP-compatible app, such as Cursor and Claude Desktop.

Does MacPilot CLI support dragging the mouse?

Not yet – the drag mouse tool is currently listed as "To Be Implemented".