applescript-mcp MCP Server

@joshrutkowski

About applescript-mcp MCP Server

A macOS AppleScript MCP server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "applescript-mcp-joshrutkowski": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "node",
        "path/to/server/index.js",
        "args..."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Frequently asked questions

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.

Comments

Basic information

More Productivity MCP servers

Computer Control MCP

AB498

MCP server that provides computer control capabilities, like mouse, keyboard, OCR, etc. using PyAutoGUI, RapidOCR, ONNXRuntime. Similar to 'computer-use' by Anthropic. With Zero External Dependencies.

150