MCP Mac Apps Server

Provides an MCP server to launch, manage, and query macOS apps via LLM with AppleScript automation.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "trueoleg-mcp-expirements": {
      "command": "python3",
      "args": [
        "/Users/olegzaichkin/Documents/MCP/src/server.py"
      ],
      "env": {
        "YOUR_ENV_VAR": "value"
      }
    }
  }
}

This MCP server enables you to control macOS applications through language models. You can launch apps, automate tasks with AppleScript, list running apps, close apps, and open files, all through an MCP client. It’s useful for building conversational workflows that directly interact with your macOS environment.

How to use

Once you configure an MCP client, you can issue natural language prompts to perform actions on your Mac. You can open apps, query which applications are running, send AppleScript commands to control applications, quit apps, and open specific files in chosen applications. Use the client’s MCP configuration to connect to the local or remote server, then rely on the available tools to execute the corresponding actions.

How to install

Prerequisites vary by how you want to run the server. Choose either the Python version or the TypeScript (Node.js) version.

Python version (recommended):

# 1) Ensure Python 3.7 or newer is installed
# 2) Install dependencies
pip install -r requirements.txt

TypeScript version (alternative):

# 1) Ensure Node.js v18+ and npm are installed
# 2) Install dependencies
npm install
# 3) Build the project
npm run build

Configuration and usage notes

You can configure the MCP client to connect to the server using the following MCP configurations. The HTTP and STDIO (local) methods are supported, and you should provide the exact command or URL shown in your setup.

Security and permissions

This server can execute commands on your system. Use it only with trusted clients and in a secure environment. On macOS, you may need permission to automate other applications: System Settings → Privacy & Security → Automation, then allow access for the terminal or Node.js.

Examples and scenarios

Open an application, list running apps, or run AppleScript commands through natural prompts. For example, you can ask to open Safari, fetch the list of running applications, or instruct a supported app to perform an action via AppleScript.

Development and testing

To test the server locally, you can run the test script if you have Node.js installed. Otherwise, you can build and start the server in development mode to observe live reloads and changes.

Notes on usage with macOS automation

Certain actions, such as AppleScript execution, are performed within the target application. Ensure automation permissions are granted for the shell and the MCP server process on your Mac.

Available tools

open_application

Opens an application by name, such as Safari or Calculator.

get_running_applications

Returns a list of all running applications.

run_applescript

Executes an AppleScript command in the specified application.

quit_application

Closes the specified application.

open_file_with_app

Opens a file or URL in the specified application.