AppleScript MCP Server

What does “AppleScript” MCP Server do?

The AppleScript MCP Server is a Model Context Protocol (MCP) server designed to provide AI assistants and development tools with the ability to run AppleScript code on a Mac. By acting as a bridge, it enables AI agents to access and control Mac applications and system functions, such as interacting with Notes, Calendar, Contacts, Messages, and more. The server supports tasks like searching files via Spotlight, reading and writing files, executing shell commands, and even remote execution through SSH. Its lightweight and intuitive design makes it easy to integrate, significantly enhancing automation, productivity, and the development workflow for Mac users by allowing programmatic access to a wide range of macOS features.

List of Prompts

No reusable prompt templates are documented in the repository. Only user-facing example prompts are provided.

List of Resources

No explicit MCP resources are described in the available documentation or code.

List of Tools

No detailed tool listing is provided in server.js or documentation. The server enables execution of arbitrary AppleScript, but specific tool primitives are not enumerated.

Use Cases of this MCP Server

• Mac Application Automation: Allows developers and AI agents to automate workflows involving Notes, Calendar, Contacts, Messages, and other macOS apps by executing AppleScript commands.
• File and System Management: Enables searching for files using Spotlight or Finder, reading and writing file contents, and managing folders and documents programmatically.
• System Information Retrieval: Facilitates querying system status such as battery percentage, disk space, and running applications, useful for both users and automated agents.
• Remote Execution: Supports executing AppleScript remotely via SSH, making it possible to manage a Mac from another machine or container.
• Media and Communication Control: Offers control over media playback (e.g., in Apple Music) and can interact with communication apps to automate emails, messages, or reminders.

How to set it up

Windsurf

1. Ensure Node.js is installed on your system.
2. Open your Windsurf configuration file.
3. Add the AppleScript MCP Server to your mcpServers section using the JSON snippet below.
4. Save the configuration and restart Windsurf.
5. Verify that the server is running and accessible.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Ensure Node.js is installed.
2. Locate and open your Claude configuration file.
3. Add the MCP server as shown in the example below.
4. Save the config and restart Claude.
5. Confirm the MCP server is available for use.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. Install Node.js on your system.
2. Open Cursor’s configuration file.
3. Insert the AppleScript MCP server entry into the mcpServers section.
4. Save and restart Cursor.
5. Check that integration is successful.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Verify Node.js is installed.
2. Edit the Cline configuration file.
3. Add the MCP server configuration as per the example below.
4. Save changes and restart Cline.
5. Test to ensure the MCP server is operational.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Securing API Keys and Credentials

For remote execution, sensitive information like SSH usernames and passwords can be provided via environment variables for better security. Example:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "yourusername",
        "REMOTE_PASSWORD": "yourpassword"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “applescript_execute” to the actual name of your MCP server and replace the URL with your own MCP server URL.

Overview

Based on the above tables, AppleScript MCP Server offers a straightforward but limited integration. Its strength lies in direct control of Mac via AppleScript. However, it lacks documented prompt templates, explicit MCP resources, and detailed tool primitives. The presence of a license, moderate popularity, and clear setup instructions are positives. Overall, it’s highly useful for its niche, but documentation depth could be better.

MCP Score