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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

Nevent

nevent

Nevent is a remote MCP server available at https://mcp.nevent.ai.

Dadan MCP

Dadan-io

dadan-sdk-integration is an SDK for integrating Dadan features into React applications. It allows you to add video recording and file selection functionality directly into your React components, providing a seamless user

Openfate Bazi Mcp

openfate-ai

OpenFate Bazi MCP server with deterministic Four Pillars calculation, True Solar Time, branch interactions, and reverse Bazi lookup.

Npx Y convex@latest mcp start

get-convex

The open-source reactive database for app developers

12.1K

Plyto

Plyto is an agentic CRM for small businesses, and this server exposes the whole platform to the AI you already use. Connect Claude, Cursor, or any MCP-compatible assistant with a per-business API key and your agent can c