macPilot

macPilot

MacPilot CLI is an open-source tool that enables interaction with macOS through the MCP. It provides a collection of system tools that allow AI assistants to perform various operations on macOS systems, including mouse control, screenshots, text pasting, application launching, and more.

huhu415

OS Automation
Visit Server

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

Tool Name Description Input Parameters
repeat Echo back the input text text: String to repeat
getCursorPosition Returns the current mouse position and screen details None
moveCursor Moves the mouse cursor to specific coordinates x: X coordinate, y: Y coordinate
clickMouse Performs a mouse click at the current cursor position None
pasteText Copies text to clipboard and pastes it text: Text to paste
captureScreen Takes a screenshot of the entire screen None
executeCommand Runs a shell command and returns the output command: Command to execute, args: Optional arguments array
launchApp Launches an application bundleId & Application identifier or appName & Application name
getAppsList Returns a list of installed applications None
getWindowsList Returns information about all windows None
getFocusedWindowInfo Returns information about the focused window None
getWindowInfo Returns detailed information about a window pid: Optional process ID

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

Recommended Servers

@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.

Featured
Local
JavaScript
Claude Code MCP

Claude Code MCP

An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.

Featured
Local
JavaScript
ThingsPanel MCP

ThingsPanel MCP

An integration server that connects AI models with ThingsPanel IoT platform, allowing AI assistants to interact with IoT devices through natural language for device control, data retrieval, and management operations.

Official
Python
Beamlit MCP Server

Beamlit MCP Server

An MCP server implementation that enables seamless integration between Beamlit CLI and AI models using the Model Context Protocol standard.

Official
TypeScript
WinTerm MCP

WinTerm MCP

A Model Context Protocol server that provides programmatic access to the Windows terminal, enabling AI models to interact with the Windows command line through standardized tools for writing commands, reading output, and sending control signals.

Local
JavaScript
MCP Server: SSH Rails Runner

MCP Server: SSH Rails Runner

Enables secure remote execution of Rails console commands over SSH for read-only operations, mutation planning, and executing approved changes in a deployed Rails environment.

Local
TypeScript
Everything Search MCP Server

Everything Search MCP Server

Provides integration with Everything Search Engine allowing powerful file search capabilities through the Model Context Protocol with advanced search options like regex, case sensitivity, and sorting.

Local
JavaScript
Blender MCP Server

Blender MCP Server

A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.

Local
Python
Node Omnibus MCP Server

Node Omnibus MCP Server

A comprehensive Model Context Protocol server that provides advanced Node.js development tooling for automating project creation, component generation, package management, and documentation with AI-powered assistance.

Local
JavaScript
mcp-installer

mcp-installer

This server is a server that installs other MCP servers for you. Install it, and you can ask Claude to install MCP servers hosted in npm or PyPi for you. Requires npx and uv to be installed for node and Python servers respectively.

Local
JavaScript