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 that allow AI assistants to perform various operations on macOS systems.

Tool Documentation

• getCursorPosition
• controlMouse
• pasteText
• captureScreen
• shell
• openApp
• listApps
• getWindowsInfo
• getWindowA11yInfo

Tools To Be Implemented

• Drag mouse

Getting Started

1. You need a Mac computer with Apple Silicon running macOS 14.0 (Sonoma) or later
2. Download the binary file from the Releases section
3. Configure your MCP-compatible application (Cursor or Claude Desktop app) by adding the following configuration:

   {
     "mcpServers": {
       "macPilotCli": {
         "command": "/path/to/downloaded/binary"
       }
     }
   }
   

4. Grant the necessary permissions (screen recording, accessibility) to the application you're using with MacPilot CLI. For example, if you're using Cursor, make sure Cursor has the required permissions in System Settings.
5. Switch to a tool-compatible model according to your application's requirements, and you're ready to use MacPilot CLI