AppleScript MCP Server (Dual access: python and node.js)

 

Overview

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

Features

* 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

Example Prompts

``
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
`

Usage with Claude Desktop

$3


`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