addLABSCO SUMMARY
The desktop, not just the browser.
What an assistant normally cannot touch on a Mac — what is on the clipboard, what is selected in Finder, whether notifications are muted — becomes readable and settable from the conversation.
What it is
A bridge to macOS through AppleScript. The session can read and set the clipboard, see what is selected in Finder, search for files, preview one with Quick Look, post a notification and switch Do Not Disturb on or off.
What you get
- The clipboard read, replaced or cleared
- The files currently selected in Finder, and a file search across the machine
- A file opened in Quick Look, without switching to a viewer app
- A native notification posted, and Do Not Disturb toggled
- The frontmost app, so an action lands where you are actually looking
Requirements
Node.js 18 or later, on macOS. It drives the desktop it runs on, so it has to run on the Mac you are sitting at.
Setup effort
Build from source — git clone https://github.com/joshrutkowski/applescript-mcp.git
USE CASES
01
Acting on the files you have selected right now
Rather than typing paths, hand over whatever is highlighted in Finder and preview one of them without leaving the window.
02
Moving text between an assistant and any app
Put the result on the clipboard so it can be pasted anywhere, read back what was copied from elsewhere, and clear it when it held something sensitive.
03
Finding a file you cannot name exactly
Search the machine for it and look inside the candidates with Quick Look until the right one turns up.
04
Being told when a long job finishes
A native notification arrives where you will see it, instead of the answer sitting unread in a window you switched away from.
05
Getting quiet for a stretch of work
Turn Do Not Disturb on for the duration, and check which app is frontmost so the action lands in the right place.
31 tools
Listed in project docs. Your client may show a different list.
listset_clipboardget_clipboardclear_clipboardget_selected_filessearch_filesquick_looksend_notificationtoggle_do_not_disturbvolumeget_frontmost_applaunch_appquit_apptoggle_dark_modepaste_clipboardrunrun_shortcutlist_shortcutscreate_emaillist_emailsget_emaillist_chatsget_messagessearch_messagescompose_messagecreatecreateRawHtmlgetsearchcreate_documentBEFORE YOU INSTALL
What to know first
Tools you get
31 tools named in the project's documentation.
Requires
- macOS 10.15 or later
- Node.js 18 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/joshrutkowski/applescript-mcp.git
cd applescript-mcp
npm install
npm run buildMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"applescript-mcp-server": {
"command": "node",
"args": [
"<YOUR_PATH_TO_APPLESCRIPT_MCP>/dist/index.js"
]
}
}
}<YOUR_PATH_TO_APPLESCRIPT_MCP> is the full path of your clone. dist/index.js exists once npm run build has run.
