macos-automator-mcp

MCP.Pizza Chef: steipete

AppleScript and JXA are the languages macOS uses to drive its own applications, and this server hands both to an assistant along with hundreds of ready-made recipes covering Finder, Safari, Mail, terminals, and productivity apps. You can ask for the front browser tab, rename a batch of files, or have an app's menus clicked through. It needs macOS, Node 24 or newer, and a pasted configuration block. The first time a script touches a given app, macOS asks you to grant permission.

Files/PDF

Other

Use This MCP server To

Grab the address of the browser tab I am reading Rename or move a folder full of files at once Ask which applications are running on my Mac right now Click through an app's menus for a repetitive chore Search a built-in library of Mac automation recipes

README

macOS Automator MCP 🤖 — Give your agent a Mac to operate

License

macOS Automator MCP is a Model Context Protocol server that lets MCP clients discover and run AppleScript or JavaScript for Automation (JXA). It is for agents that need to control macOS applications, inspect the system, or reuse scripts from a bundled knowledge base.

Install

You need macOS and Node.js 24 or newer. Add the server to your MCP client's configuration; npx downloads the current npm release when the client starts it.

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

If your client has a separate package field, use @steipete/macos-automator-mcp without @latest.

Quick start

Restart your MCP client after adding the configuration. First, ask it to call get_scripting_tips with a small search:

macos-automator-mcp FAQ

Do I need a Mac?

Yes. It runs AppleScript and JXA, which only exist on macOS, and it needs Node 24 or newer.

Do I need an API key?

No. Everything runs locally on your own machine.

Can I use this to have my assistant tidy up a folder of files?

Yes — file and Finder chores are one of the largest categories in its built-in recipe library.

How hard is setup?

You paste a short configuration block into your app. The extra step is granting macOS permissions the first time a script controls something.

Is it safe to let it run scripts?

Scripts run with the same powers as whatever launched the server, so read what it plans to run before approving anything destructive.

Why does it keep asking for permission?

macOS prompts once per application for Automation access, and separately for Accessibility when a script clicks buttons or types.