Applescript MCP Server

A macOS AppleScript MCP server

Local serverstdioTypeScript

What is the Applescript MCP server?

If you already use Applescript, the applescript mcp server is the piece that lets your assistant work with it directly. A macOS AppleScript MCP server.

What the server does

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.

  • 🗓️ Calendar management (events, reminders)
  • 📋 Clipboard operations
  • 🔍 Finder integration
  • 🔔 System notifications
  • ⚙️ System controls (volume, dark mode, apps)
  • 📟 iTerm terminal integration

Installation

The server ships on npm as @modelcontextprotocol/inspector, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Calendar — The Calendar tool exposed by this server
  • Examples — // List today's events What events do I have scheduled for today?
  • Clipboard — The Clipboard tool exposed by this server
  • Finder — The Finder tool exposed by this server
  • Notifications — The Notifications tool exposed by this server
  • System — The System tool exposed by this server
  • iTerm — The iTerm tool exposed by this server
  • Shortcuts — The Shortcuts tool exposed by this server
  • Mail — The Mail tool exposed by this server
  • Messages — The Messages tool exposed by this server
  • Notes — The Notes tool exposed by this server
  • Pages — The Pages tool exposed by this server

Credentials and setup notes

  • macOS 10.15 or later - Node.js 18 or later

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Applescript.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the planning and project tracking group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Applescript's toolset — Calendar, Examples, Clipboard and 11 more — is a fair guide to whether it matches your workflow. It is maintained by joshrutkowski; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Applescript's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
CalendarThe Calendar tool exposed by this server.
Examples// List today's events What events do I have scheduled for today?
ClipboardThe Clipboard tool exposed by this server.
FinderThe Finder tool exposed by this server.
NotificationsThe Notifications tool exposed by this server.
SystemThe System tool exposed by this server.
iTermThe iTerm tool exposed by this server.
ShortcutsThe Shortcuts tool exposed by this server.
MailThe Mail tool exposed by this server.
MessagesThe Messages tool exposed by this server.
NotesThe Notes tool exposed by this server.
PagesThe Pages tool exposed by this server.
SetupThe Setup tool exposed by this server.
LoggingThe Logging tool exposed by this server.

How to install the Applescript MCP server

{
  "mcpServers": {
    "applescript-mcp-joshrutkowski": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • macOS 10.15 or later - Node.js 18 or later

Example prompts to try

  • Use Applescript to Calendar.
  • Use Applescript to Examples.
  • Use Applescript to Clipboard.

Frequently asked questions

macOS 10.15 or later and Node.js 18 or later are required.