Back to Home
steipete icon

macos-automator-mcp

by steipete

Overview

Transforms an AI assistant into a macOS automation agent, allowing it to execute AppleScript and JavaScript for Automation (JXA) commands to control applications and system functions.

Installation

Run Command
npx -y @steipete/macos-automator-mcp@latest

Environment Variables

  • LOG_LEVEL
  • MCP_E2E_TESTING
  • VITEST
  • KB_PARSING
  • LOCAL_KB_PATH

Security Notes

The server's core functionality involves executing arbitrary AppleScript/JXA code, either directly provided by the client or sourced from its knowledge base, via `osascript`. This grants high privileges to the executing AI, including the ability to run shell commands (`do shell script`) and interact with the file system and other applications. While placeholder substitution includes escaping, it cannot mitigate malicious logic within the scripts themselves. Network requests can be made from JXA scripts via the Objective-C bridge, potentially exposing data or fetching malicious content. The README explicitly highlights the critical need for user-granted macOS Automation and Accessibility permissions, indicating a high-trust environment is required. If the AI agent itself is compromised or unconstrained, it could pose significant risks.

Similar Servers

Stats

Interest Score97
Security Score7
Cost ClassMedium
Avg Tokens1000
Stars498
Forks29
Last Update2025-12-02

Tags

macOS automationAppleScriptJXAMCPAI assistantdesktop control