macOS Automator MCP

Content

macOS Automator MCP lets Claude execute AppleScript and JavaScript for Automation on macOS. It exposes an execute_script tool for inline scripts, absolute script paths, or knowledge-base script IDs, plus a get_scripting_tips tool for discovering reusable automation recipes.

Use it when Claude needs supervised access to macOS automation tasks such as controlling apps, reading browser or Finder state, preparing scripts, searching the built-in knowledge base, or running vetted scripts under the permissions of the host application.

Source Review

• https://github.com/steipete/macos-automator-mcp
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/README.md
• https://registry.npmjs.org/@steipete%2Fmacos-automator-mcp
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/LICENSE
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/package.json
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/start.sh
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/src/server.ts
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/src/ScriptExecutor.ts
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/src/schemas.ts
• https://raw.githubusercontent.com/steipete/macos-automator-mcp/main/src/services/knowledgeBaseService.ts

These sources were reviewed on 2026-06-06. Prefer the live repository, README, npm registry metadata, license, package manifest, launcher script, server entrypoint, script executor, input schemas, and knowledge-base service for current installation and behavior details.

Features

• Run AppleScript through osascript.
• Run JavaScript for Automation by passing the JavaScript language option.
• Execute inline script content, absolute script paths, or knowledge-base script IDs.
• Pass positional arguments or structured input_data into supported scripts.
• Configure execution timeout and AppleScript output formatting.
• Optionally include executed script content, substitution logs, and execution timing in responses.
• Search a built-in knowledge base of macOS automation tips and reusable script IDs.
• Load custom knowledge-base overrides from a local path.
• Control logging verbosity and lazy or eager knowledge-base parsing through environment variables.

Installation

Add the npm package to an MCP client on macOS:

{
  "mcpServers": {
    "macos_automator": {
      "command": "npx",
      "args": [
        "-y",
        "--package",
        "@steipete/macos-automator-mcp",
        "macos-automator-mcp"
      ]
    }
  }
}

Claude Code users can add it with:

claude mcp add macos-automator -- npx -y --package @steipete/macos-automator-mcp macos-automator-mcp

After adding the server, grant the terminal, editor, or app that launches the server only the macOS Automation and Accessibility permissions needed for the apps and workflows you intend to automate.

Use Cases

• Ask Claude to find an existing AppleScript recipe before writing a new one.
• Run a vetted script that reads the current Safari tab URL.
• Automate Finder file organization on a test folder.
• Control app windows or settings under macOS Automation permissions.
• Prototype JXA scripts with explicit timeouts and visible output.
• Build a private local knowledge base of approved automation recipes.
• Debug script permissions and output formatting for a macOS workflow.

Safety and Privacy

This server runs scripts on the local Mac. Treat execute_script like a local automation and code-execution capability, not a read-only helper. Review scripts before running them, keep permissions narrow, and test destructive or app-writing workflows on disposable files or a separate macOS user account.

Automation and Accessibility permissions can allow the host process to control apps, inspect UI state, send keystrokes, click buttons, read windows, and change settings. Give those permissions only to trusted launchers and only for the apps needed by the workflow.

Script output can include private local data from files, browser tabs, clipboard, messages, email, calendars, contacts, shell commands, and app state. Avoid sharing transcripts that include script inputs, outputs, paths, local knowledge-base entries, or permission errors.

Duplicate Check

Existing entries include narrower macOS automation surfaces such as iTerm MCP, but no macOS Automator MCP, steipete/macos-automator-mcp, @steipete/macos-automator-mcp, or general AppleScript/JXA automation MCP entry was found in content/mcp.

• Source repositorygithub.com 2026-07-21T07:17:01+00:00
• Documentationraw.githubusercontent.com
• Submitted by oktofeesh12026-06-06