applescript-mcp
- OS Automation
Enables LLM applications to interact with macOS through AppleScript.
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DEBUG | No | Enable debug logging for applescript-mcp |
applescript-mcp MCP Server
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.
Features
- 🗓️ Calendar management (events, reminders)
- 📋 Clipboard operations
- 🔍 Finder integration
- 🔔 System notifications
- ⚙️ System controls (volume, dark mode, apps)
- 📟 iTerm terminal integration
Planned Features
- 📬 Mail (list emails, save attachments, summarize, send)
- 🧭 Safari (open in Safari, save page content, get selected page/tab)
- 💬 Messages (send, get, list)
- ✅ Reminders (create, get)
- 🗒️ Notes (create, get, list)
Prerequisites
- macOS 10.15 or later
- Node.js 18 or later
Available Categories
Calendar
| Command | Description | Parameters |
|---|---|---|
add | Create calendar event | title, startDate, endDate |
list | List today's events | None |
Clipboard
| Command | Description | Parameters |
|---|---|---|
set_clipboard | Copy to clipboard | content |
get_clipboard | Get clipboard contents | None |
clear_clipboard | Clear clipboard | None |
Finder
| Command | Description | Parameters |
|---|---|---|
get_selected_files | Get selected files | None |
search_files | Search for files | query, location (optional) |
quick_look | Preview file | path |
Notifications
| Command | Description | Parameters |
|---|---|---|
send_notification | Show notification | title, message, sound (optional) |
toggle_do_not_disturb | Toggle DND mode | None |
System
| Command | Description | Parameters |
|---|---|---|
volume | Set system volume | level (0-100) |
get_frontmost_app | Get active app | None |
launch_app | Open application | name |
quit_app | Close application | name, force (optional) |
toggle_dark_mode | Toggle dark mode | None |
iTerm
| Command | Description | Parameters |
|---|---|---|
paste_clipboard | Paste to iTerm | None |
run | Execute command | command, newWindow (optional) |
Development
Setup
Adding New Functionality
1. Create Category File
Create src/categories/newcategory.ts:
2. Add Scripts
3. Register Category
Update src/index.ts:
Debugging
Using MCP Inspector
The MCP Inspector provides a web interface for testing and debugging your server:
Logging
Enable debug logging by setting the environment variable:
Common Issues
- Permission Errors: Check System Preferences > Security & Privacy
- Script Failures: Test scripts directly in Script Editor.app
- Communication Issues: Check stdio streams aren't being redirected
Resources
Contributing
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request
License
MIT License - see LICENSE for details
GitHub Badge
Glama performs regular codebase and documentation scans to:
- Confirm that the MCP server is working as expected.
- Confirm that there are no obvious security issues with dependencies of the server.
- Extract server characteristics such as tools, resources, prompts, and required parameters.
Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.
Copy the following code to your README.md file: