MCP server for executing AppleScript
npm install @peakmojo/applescript-mcp 
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.
https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388
* 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
json
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp"
]
}
}
}
`$3
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"
]
}
}
}
`Docker Usage
When running in a Docker container, you can use the special hostname
host.docker.internal to connect to your Mac host:$3
`json
{
"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:
1. SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
2. Your user has proper permissions
3. The correct credentials are provided in the config