MCP.so
Sign In

applescript-mcp MCP Server

@joshrutkowski

Basic information

Category

Productivity

License

MIT

Transports

stdio

Author

joshrutkowski

About applescript-mcp MCP Server

A macOS AppleScript MCP server

applescript-mcp 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..."
      ]
    }
  }
}

applescript-mcp MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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.

Frequently asked questions

1

What are the prerequisites for using the server?

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

2

How do I enable notifications?

Send a notification requires enabling notifications in System Settings > Notifications > Script Editor.

3

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`.

4

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.

5

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

More Productivity MCP servers