Design Engineer Logo
Visit Repo
Open Graph preview

Applescript MCP

A macOS AppleScript MCP server

Site favicon
⚡️ System Operation

Overview

AppleScript MCP

Description:
A macOS server enabling AI applications to control system functions via AppleScript

Category: System Integration / Automation

Overview:
This server provides native macOS system control through AppleScript integration. It enables powerful automation capabilities across various system functions:

  • Calendar operations (events & reminders)
  • Clipboard management
  • Finder integration
  • System notifications
  • System controls (volume, dark mode, applications)
  • iTerm terminal integration

System Requirements:

  • macOS 10.15+
  • Node.js 18+

Setup:

npm install
npm run build

# Launch Inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js

Configuration Example:

{
  "mcp-server-applescript": {
    "command": "/usr/local/bin/node",
    "args": ["./dist/index.js"],
    "env": {
      "DEBUG": "applescript-mcp*"
    }
  }
}

Important Notes:

  • Verify System Preferences > Security & Privacy settings for permissions
  • Test scripts in Script Editor.app for troubleshooting
  • Debug mode available via DEBUG environment variable
  • Planned expansions include Mail, Safari, Messages, Reminders, and Notes integration

The server provides a robust foundation for AI applications to interact with macOS system functions through a standardized interface.