A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. This MCP is intentionally designed to be simple, straightforward, intuitive, and require minimal setup.
I can't believe how simple and powerful it is. The core code is <100 line of code.
applescript.mcp.demo.0422.mp4
- Run AppleScript to access Mac applications and data
- Interact with Notes, Calendar, Contacts, Messages, and more
- Search for files using Spotlight or Finder
- Read/write file contents and execute shell commands
- Remote execution support via SSH
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? Show me the most recent unread emails in my inbox List all the currently running applications on my Mac Play my "Focus" playlist in Apple Music Take a screenshot of my entire screen and save it to my Desktop Find John Smith in my contacts and show me his phone number Create a folder on my Desktop named "Project Files" Open Safari and navigate to apple.com Tell me how much free space I have on my main drive List all my upcoming calendar events for this week { "mcpServers": { "applescript_execute": { "command": "npx", "args": [ "@peakmojo/applescript-mcp" ] } } }Install uv
brew install uv git clone ... Run the server
{ "mcpServers": { "applescript_execute": { "command": "uv", "args": [ "--directory", "/path/to/your/repo", "run", "src/applescript_mcp/server.py" ] } } } When running in a Docker container, you can use the special hostname host.docker.internal to connect to your Mac host:
{ "mcpServers": { "applescript_execute": { "command": "npx", "args": [ "@peakmojo/applescript-mcp", "--remoteHost", "host.docker.internal", "--remoteUser", "yourusername", "--remotePassword", "yourpassword" ] } } }This allows your Docker container to execute AppleScript on the Mac host system. Make sure:
- SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
- Your user has proper permissions
- The correct credentials are provided in the config