Overview
What is applescript-mcp MCP Server?
A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript. It provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more. Designed for macOS users running Node.js 18+.
How to use applescript-mcp MCP Server?
Install dependencies with npm install, build the server with npm run build, then launch using MCP Inspector for testing. Configure your MCP client to point to the built server.
Key features of applescript-mcp MCP Server
- Calendar management (events, reminders)
- Clipboard operations (set, get, clear)
- Finder integration (file search, preview)
- System notifications and Do Not Disturb toggle
- iTerm terminal integration (run commands, paste)
- Shortcuts automation (run and list shortcuts)
- Mail, Messages, Notes, and Pages control
Use cases of applescript-mcp MCP Server
- Create calendar events or list today’s schedule using natural language.
- Search for files in Finder and preview their contents.
- Send system notifications and control Do Not Disturb mode.
- Automate iTerm commands and run macOS Shortcuts.
- Compose emails, send iMessages, and create formatted notes.
FAQ from applescript-mcp MCP Server
What are the prerequisites for using the server?
macOS 10.15 or later and Node.js 18 or later are required.
How do I enable notifications?
Send a notification requires enabling notifications in System Settings > Notifications > Script Editor.
Can I add new functionality?
Yes. Create a category file in src/categories/, define scripts using the provided interfaces, and register it in index.ts.
What transports or authentication are supported?
The server uses the MCP protocol for communication; no additional transport or authentication details are mentioned in the README.
How does the server execute AppleScript commands?
It runs AppleScript via the macOS osascript command, identified by the category and script requested by the client.
