Applescript BB MCP Server

Created at 2 months ago

by Charlie Garrison

starstarstarstarstar

MCP server that enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

Categories

developer-tools

Tags

macos

applescript

mcp

mcp-server

agentic-ai

open-source

deno

typescript

Applescript BB MCP Server

What is Applescript BB MCP Server?

The Applescript BB MCP Server is a production-ready server that allows LLM clients to interact with macOS applications through AppleScript, enabling safe and controlled execution of predefined scripts.

How to use Applescript BB MCP Server?

To use the server, run the command deno run --allow-all --unstable-kv jsr:@beyondbetter/bb-applescript-mcp-server and configure your environment for plugin loading as needed.

Key features of Applescript BB MCP Server?

  • 🔒 Safe by Default: Arbitrary script execution is disabled by default.
  • 📦 Plugin Architecture: Modular design with task-focused plugins.
  • 🛠️ Standard Tools: Includes tools for reading dictionaries, checking permissions, and performing Finder operations.
  • 📝 BBEdit Integration: Allows for the creation of notebooks and projects.
  • ⏱️ Timeout Protection: Configurable timeouts to prevent runaway scripts.
  • 📄 Structured Errors: Consistent error handling with LLM-friendly hints.
  • 📊 Performance: Supports both compiled and template-based scripts.

Use cases of Applescript BB MCP Server?

  1. Automating BBEdit projects and integrating with development tools through AI conversations.
  2. Managing files and organizing them using natural language commands.
  3. Controlling macOS applications that support AppleScript via an AI assistant.

FAQ from Applescript BB MCP Server?

  • Can I execute arbitrary scripts?

Arbitrary script execution is disabled by default for security reasons. You can enable it if you trust the LLM client.

  • How do I add custom plugins?

Create a plugin directory, add your plugin files, set the environment variable for plugin discovery, and restart the server.

  • What are the security considerations?

Scripts run with server process permissions, and timeout limits are enforced to prevent runaway scripts.

View More