A Model Context Protocol server that enables executing AppleScript code to interact with Mac applications, files, and system functions through natural language commands.

Installation

NPX

npx @peakmojo/applescript-mcp

Python with UV

brew install uv
git clone ...

Configuration

Claude Desktop - Node.js

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude Desktop - Python

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "src/applescript_mcp/server.py"
      ]
    }
  }
}

Docker Configuration

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp",
        "--remoteHost", "host.docker.internal",
        "--remoteUser", "yourusername",
        "--remotePassword", "yourpassword"
      ]
    }
  }
}

Capabilities

• Execute AppleScript to access Mac applications and data
• Interact with Notes, Calendar, Contacts, Messages, and much more
• Search files via Spotlight or Finder
• Read/write file contents and execute shell commands
• Support for remote execution via SSH

Usage Examples

Create a reminder for me to call John tomorrow at 10am

Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"

Create a new note titled "Meeting Minutes" with today's date

Show me all files in my Downloads folder from the past week

What's my current battery percentage?

Notes

Supports implementations in both Node.js and Python. Using Docker requires SSH to be enabled on Mac with proper credentials. The core code is less than 100 lines, emphasizing simplicity and minimal setup.