Overview
A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. This MCP is designed to be simple, straightforward, intuitive, and require minimal setup. The core code is under 100 lines. It supports dual access through Node.js and Python, with usage examples for both environments (npx @peakmojo/applescript-mcp; uv to run server.py). It enables running AppleScript to access Mac applications and data, and supports interacting with Notes, Calendar, Contacts, Messages, and more. It can search for files via Spotlight or Finder, read and write file contents, and execute shell commands. Remote execution via SSH is supported, and it is Docker-friendly with configuration examples showing how to connect from a container using host.docker.internal, including prerequisites like enabling Remote Login, proper permissions, and credentials. The server is intended to be integrated with LLMs and automation workflows to automate macOS tasks with minimal setup.
Features
Run AppleScript to access Mac applications and data
Execute AppleScript code to interact with macOS apps and system data.
Interact with Notes, Calendar, Contacts, Messages, and more
Manipulate core macOS apps and data via AppleScript.
Search for files using Spotlight or Finder
Find files quickly using Spotlight indexing or Finder queries.
Read/write file contents and execute shell commands
Read and modify files and run shell commands through AppleScript-enabled workflows.
Remote execution via SSH
Execute AppleScript tasks on a Mac remotely over SSH.
Dual access: Node.js and Python interfaces
Use either npm/npx or Python UV-based server to run the MCP.
Lightweight, minimal setup MCP server
Core MCP server with less than 100 lines of code for simplicity and speed.
Docker-friendly and cross-environment usage
Works in Docker with host connectivity and remote host configuration.
Who Is This For?
- LLM developers:Integrate AppleScript automation into MCP-enabled workflows using Node.js or Python.
- Mac automation enthusiasts:Run AppleScript to automate notes, calendar, contacts, and more on macOS.
- DevOps for Macs:Control Mac host remotely via SSH or Docker with MCP AppleScript server.
