mcpField
M
MacPilot CLI

MacPilot CLI

Local
github.com/huhu415Developer Tools16Updated 77w ago
Repository

About MacPilot CLI

MacPilot CLI is an open-source tool that lets LLMs interact with macOS over MCP. It is for AI assistants that need to operate a Mac's system and interface, with tools for mouse, screen, windows, apps, and shell operations.

Key features

  1. 01Get cursor position and control mouse
  2. 02Paste text and capture screen
  3. 03Run shell commands
  4. 04Open and list apps
  5. 05Inspect windows and accessibility information

Use cases

  1. 01Let an AI assistant operate macOS apps
  2. 02Capture the screen and inspect window details
  3. 03Perform interface actions with mouse and text input

MCP support

It exposes macOS system tools to MCP-compatible applications. Once configured in an MCP client, its mouse, screen, app, window, and shell tools can be called.

#macos#agent#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.