AppleScript MCP Server
MCP server for AppleScript: the agent runs scripts and controls Mac apps, from Notes and Calendar to files
- 468 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Gives an agent full access to Mac apps and files
- Runs shell commands with no built-in limits
- The remote SSH option needs host credentials
Install
- Works in
Manual install
npx @peakmojo/applescript-mcpNode.js flavor without a system install.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Gives an agent full access to Mac apps and files
- Runs shell commands with no built-in limits
- The remote SSH option needs host credentials
This is third-party code. Review the repository files before installing.
What it does
The server lets an agent run AppleScript and through it control macOS. It can work with Notes, Calendar, Contacts, Messages and other apps, find files via Spotlight or Finder, read and write file contents and run shell commands. The server is deliberately simple and needs minimal setup, and comes in two flavors: Node.js and Python. It supports remote execution over SSH, including from a docker container to the Mac host.
Who it is for. For macOS users and developers who want to automate Mac apps from an agent.
Good fit when
- You want to create a reminder, note or calendar event from an agent
- You need to find files and read their contents on a Mac
- You want to control Mac apps through AppleScript
Not a fit when
- You are not on macOS
- You cannot give an agent full access to Mac apps and files
- You need limits on which scripts and commands run; there are none built in
Example request
Create a note titled Meeting Minutes with today's dateMCP
- Transport
- stdio
- Authentication
- not required
Limitations
It runs on macOS and relies on AppleScript, so its reach equals what system permissions allow. The server runs scripts and shell commands with no built-in limits, and responsibility is on the user. The remote SSH option needs Remote Login enabled and credentials passed in, which should not be kept in plain config.
How to disable. Remove the applescript_execute entry from your MCP client config.
FAQ
Node.js or Python?
Both are available. Node.js runs via npx, and the Python option runs via uvx straight from the repository.
Can I run AppleScript on the Mac from a container?
Yes, over SSH using the host.docker.internal hostname. You must enable Remote Login on the Mac and pass credentials.
Discussion
No questions or reviews yet.
Related
MCP serversA macOS MCP server on AppleScript: the agent drives Calendar, Mail, Messages, Notes, Finder, iTerm and Shortcuts
MCP server for macOS desktop control through the Accessibility API: clicks, typing, windows, apps, shell commands and AppleScript
An MCP server for macOS: the agent moves the mouse, types, manages windows and captures the screen when an app has no API
A Swift MCP server that lets an agent drive any macOS app: click, type and read the interface tree
An MCP server for driving Windows: the agent opens apps, clicks and types, reads window and UI state, and works with files and PowerShell
An MCP server helps an agent build and test Python automation tasks for Windows applications and Android devices.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| AppleScript MCP Server (this card) | no | not required | 468 | |
| kubectl-mcp-server | no | not required | 972 | reads cluster state and diagnoses pod failures |
| Unreal Engine MCP Server | no | not required | 1,033 | Unreal Engine assets, actors and blueprints |
| Android MCP | no | not required | 924 | controls an Android device through ADB |
README in short
The README describes a server that executes AppleScript and reaches Mac apps and data. It lists working with Notes, Calendar, Contacts, Messages, file search via Spotlight and Finder, reading and writing files, shell commands and remote execution over SSH. It shows Claude Desktop configs for the Node.js path via npx and the Python path via uvx, plus local development with uv and running in docker. There are many everyday command examples. MIT licensed.