applescript

The AppleScript MCP server exposes an HTTP API that lets you send AppleScript commands to your macOS machine for execution. Once started with npm start, the server is ready to receive requests containing AppleScript code and will execute those scripts on the host Mac. Use the provided endpoint (as shown in the project docs) to POST AppleScript payloads such as tell application commands, script blocks, or more complex AppleScript logic. The server acts as a bridge between your devices and macOS automation capabilities, enabling remote control of applications, filesystem actions, and system tasks via simple HTTP requests.

Prerequisites:

• macOS machine to run the server
• Node.js and npm installed

Install and run:

1. Clone the repository or download the release package.
2. Open a terminal in the project directory.
3. Install dependencies:

npm install

4. Start the MCP server:

npm start

5. The server will start and listen for incoming HTTP requests that carry AppleScript commands.

Tips:

• Ensure your macOS firewall allows incoming connections if you plan to access the server from other devices.
• When sending AppleScript commands, ensure proper escaping of quotes within the payload.
• Review the server logs for any AppleScript execution errors or permission prompts on macOS.
• If you need to customize the listening port or endpoints, check the configuration options in the server source or environment variables (if provided by the project).
• Running AppleScript commands can require accessibility permissions on macOS; ensure the terminal or the running process has the necessary permissions.