drio
Open app

MacPilot CLI

Source

MacPilot CLI is a mcp server, It provides a collection of system tools that allow AI assistants to perform various operations on macOS systems.

Catalog onlyCatalog onlySTDIO

Overview

MacPilot CLI is an open-source tool that enables interaction with macOS through the Model Control Protocol (MCP). It allows AI assistants to perform various operations on macOS systems, such as mouse control, screenshots, text pasting, and application launching.

To use MacPilot CLI, you need a Mac computer with Apple Silicon running macOS 14.0 (Sonoma) or later. Download the binary file from the Releases section on GitHub, configure your MCP-compatible application, and grant the necessary permissions.

  • Control mouse movements and clicks - Take screenshots of the entire screen - Paste text from the clipboard - Launch applications and execute shell commands - Retrieve information about installed applications and windows
  1. Automating repetitive tasks on macOS using AI assistants.
  2. Enhancing accessibility features for users with disabilities.
  3. Integrating with AI models to perform complex operations on macOS.

Add to your AI client

Use these steps to connect MacPilot CLI in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "macpilotcli-huhu415": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "macpilotcli-huhu415": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "macpilotcli-huhu415": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "macpilotcli-huhu415": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "macpilotcli-huhu415": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "macpilotcli-huhu415": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-macpilotcli-huhu415"
      ]
    }
  }
}

FAQ

What macOS versions are supported?

MacPilot CLI supports macOS 14.0 (Sonoma) and later.

Is MacPilot CLI free to use?

Yes! MacPilot CLI is an open-source tool and is free to use.

What permissions are required to use MacPilot CLI?

You need to grant screen recording and accessibility permissions to the application using MacPilot CLI.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3009,"uuid":"ea26a0ad-8cf8-42f5-afdb-75717009835a","name":"macPilotCli","title":"MacPilot CLI","description":"MacPilot CLI is a mcp server, It provides a collection of system tools that allow AI assistants to perform various operations on macOS systems.","avatar_url":"https://avatars.githubusercontent.com/u/93107032?v=4","created_at":"2025-03-16T14:40:20.262Z","updated_at":"2025-03-17T12:29:11.534Z","status":"created","author_name":"huhu415","author_avatar_url":"https://avatars.githubusercontent.com/u/93107032?v=4","tags":"macos,agent,mcp-server","category":"os-automation","is_featured":false,"sort":1,"url":"https://github.com/huhu415/macPilotCli","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"6\",\"license\":\"\",\"language\":\"Swift\",\"is_official\":false,\"latest_commit_time\":\"2025-05-01 22:22:13\"}","user_uuid":"007eac98-e0ce-4261-b142-409071e3c60a","tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Os automation