applescript-mcp
by joshrutkowski
applescript-mcp is a Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript. This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.
Last updated: N/A
What is applescript-mcp?
applescript-mcp is an MCP server that allows LLM applications to control macOS using AppleScript. It provides a standardized way for AI to interact with system functions, manage files, and handle notifications.
How to use applescript-mcp?
To use applescript-mcp, you need macOS 10.15 or later and Node.js 18 or later. After installing dependencies and building the server, you can launch the MCP Inspector to test and debug. The server exposes various categories (Calendar, Clipboard, Finder, etc.) with commands that can be invoked by LLM applications.
Key features of applescript-mcp
Calendar management (events, reminders)
Clipboard operations
Finder integration
System notifications
System controls (volume, dark mode, apps)
iTerm terminal integration
Use cases of applescript-mcp
Automating calendar event creation and management using AI.
Copying and pasting content using voice commands.
Searching for files and previewing them using AI.
Sending system notifications based on AI analysis.
Controlling system volume and toggling dark mode using AI.
FAQ from applescript-mcp
What are the prerequisites for running applescript-mcp?
What are the prerequisites for running applescript-mcp?
macOS 10.15 or later and Node.js 18 or later are required.
How can I debug the server?
How can I debug the server?
You can use the MCP Inspector or enable debug logging by setting the environment variable DEBUG=applescript-mcp* npm start.
What are some common issues I might encounter?
What are some common issues I might encounter?
Permission errors, script failures, and communication issues are common problems. Check System Preferences > Security & Privacy, test scripts directly in Script Editor.app, and ensure stdio streams aren't being redirected.
How do I add new functionality to the server?
How do I add new functionality to the server?
Create a new category file, add scripts to it, and register the category in src/index.ts.
Where can I find more information about AppleScript and MCP?
Where can I find more information about AppleScript and MCP?
Refer to the AppleScript Language Guide and MCP Protocol Documentation.