bb-applescript-mcp-server is a Model Context Protocol (MCP) server. It allows large language model (LLM) clients to communicate with macOS applications using AppleScript. Built with the @beyondbetter/bb-mcp-server library, it safely executes predefined scripts. It also supports executing custom scripts, giving you more control over your macOS applications.
Follow these simple steps to download and run the server.
To use bb-applescript-mcp-server, ensure you have the following:
- macOS 10.14 or higher
- AppleScript enabled on your system
- A stable internet connection for downloading files
To download the latest version of bb-applescript-mcp-server, visit the Releases page.
On the Releases page, you will see the latest version listed. Click on the version to view its details. Look for the download link that matches your system. Click the download link to save the application to your computer.
Once the download finishes, find the file in your Downloads folder or the location you selected for downloads. The file will typically have the extension .dmg.
To install bb-applescript-mcp-server:
- Find the downloaded
.dmgfile and double-click it. - A new window will appear. Drag the bb-applescript-mcp-server icon into your Applications folder.
- Eject the .dmg file after the dragging is completed.
After installation:
- Go to your Applications folder.
- Find bb-applescript-mcp-server and double-click to open.
- If prompted, confirm that you want to open the application.
Once open, you'll see a simple interface. Configure the settings according to your needs. You can set predefined scripts or allow for custom scripts to run as per your requirement.
To use AppleScript with the server:
- Open the AppleScript Editor (found in Applications > Utilities).
- Write or copy your AppleScript code.
- Save it in a location you'll remember.
- In bb-applescript-mcp-server, load the script to execute it.
- Safe Execution: Runs only approved scripts for security.
- Custom Script Support: Allows users to run their own AppleScripts.
- Easy Configuration: User-friendly interface for easy setup and adjustments.
- Integration with LLM Clients: Seamlessly work with large language models for advanced functionalities.
- Documentation: For detailed usage and advanced features, refer to the official documentation linked in the Releases page.
- Support: If you encounter issues, raise them in the Issues section in this repository.
- appleevent
- applescript
- bbedit
- bbedit-chat-api
- beyond-better
- deno
- llm
- llm-agent
- mcp
- mcp-server
If you have any questions or feedback, feel free to reach out through the support section on GitHub. Your input helps us enhance the application for everyone's benefit.
For a quick start, download the application now from the Releases page. Follow the installation steps above to get bb-applescript-mcp-server up and running smoothly on your macOS system.