Apple

A MCP server that runs MacOS applications by launching a Node-based MCP entry point for local automation.

javascript

4

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 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": {
    "gnosis23-apple-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/apple-mcp-server/build/index.js"
      ]
    }
  }
}

Apple MCP Server lets you run MacOS applications through a Node-based MCP entry point, enabling local automation and orchestration from MCP clients.

How to use

To use this MCP server, configure your MCP client to target the local Node process that serves the MCP entry point. Your client will request actions and receive responses that trigger MacOS app runs through the server. You can initiate launching of apps, control playback prompts, and route results back to your MCP client through the standard MCP workflows.

Prompts you can trigger include starting playback of music and proceeding to the next track. Use these prompts from your MCP client to drive your MacOS automation scenarios.

How to install

Prerequisites you need installed on your machine before setting up the MCP server are Node.js and a package manager that can run PNPM commands.

# Clone the MCP server repository
git clone https://github.com/gnosis23/apple-mcp-server.git
cd apple-mcp-server

# Install dependencies and build
pnpm install
pnpm run build

To run the server, point your MCP client to the Node entry point in the built output.

node /absolute/path/to/apple-mcp-server/build/index.js

Additional notes

If you plan to run the server directly, ensure the build output path remains consistent with your environment. You can automate startup by including the node command in your MCP client configuration so that the MCP system can launch and communicate with the server as part of your workflow.

The server is licensed under the MIT License, which allows broad use and modification with attribution as required by the license terms.