bb-applescript-mcp-server
Verified Safeby pachipalabharath
Overview
Enables LLM clients to automate macOS applications using AppleScript, providing predefined tools for Finder and BBEdit, and supporting custom plugin development.
Installation
deno run --allow-all --unstable-kv jsr:@beyondbetter/bb-applescript-mcp-serverEnvironment Variables
- LOG_LEVEL
- ENABLE_ARBITRARY_SCRIPTS
- PLUGINS_DISCOVERY_PATHS
- PLUGINS_ALLOWED_LIST
- PLUGINS_BLOCKED_LIST
- APPLESCRIPT_TIMEOUT_DEFAULT
- APPLESCRIPT_TIMEOUT_MAX
- DEBUG_APPLESCRIPT
- DEBUG_APPLESCRIPT_SAVE_ALL
- DEBUG_APPLESCRIPT_DIR
- DEBUG_APPLESCRIPT_CONTEXT
Security Notes
The server includes a `run_script` tool that allows executing arbitrary AppleScript code, which is a significant security risk. However, this tool is disabled by default, and the documentation provides clear warnings about its dangers and instructions for enabling it. Input validation for other tools is implemented using Zod schemas, and AppleScript string interpolation includes escaping to prevent injection. The server relies on macOS's native automation permissions, requiring user consent for application control. If `ENABLE_ARBITRARY_SCRIPTS` is kept `false` (default), the server is reasonably secure for its intended purpose.
Similar Servers
XcodeBuildMCP
Provides an MCP (Model Context Protocol) server for AI agents and other clients to programmatically build, test, run, and debug iOS and macOS applications, manage simulators/devices, and capture logs.
osaurus
Osaurus is an AI edge runtime for macOS, enabling users to run local and cloud AI models, orchestrate tools via the Model Context Protocol (MCP), and power AI applications and workflows on Apple Silicon.
wcgw
Empowering chat applications to code, build, and run on your local machine by providing tightly integrated shell and code editing tools.
macos-automator-mcp
Transforms an AI assistant into a macOS automation agent, enabling it to execute AppleScript and JXA commands to control applications and system functions.