M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
A

AppleScript MCP Server

Community
Execute AppleScript to get full control of your Mac
How to install ↓ Compare GitHub source repository ↗
Category
Dev Tools #348 of 438
Stars
★ 465 Popular
Transport
stdio (local process)
Runtime
Node.js · Python · Docker
Credentials
No credential needed
License
MIT
Last commit
⚠
Tools
1
41FMRS · D

AppleScript MCP Server is a simple, lightweight MCP server that gives control of your Mac via AppleScript. It offers multiple installation methods (Node.js, Python) and supports remote execution. However, it grants permission to execute arbitrary code, so users should be cautious and ensure they use it in a safe environment.

Strongest · Setup experience 10/20 Weakest · Reliability 5/20

Reliability
5/20
Security and permissions
7/20
Maintenance
10/20
Documentation
9/20
Setup experience
10/20
Why each score
Reliability 5/20
Evidence shows the server core is less than 100 lines, with both python and node versions, and there are tests and CI configuration. However, static review cannot execute code, and claims of 100% coverage need verification. Thus a score of 5 is given because the code may be plausible but actual behavior is unverified and error handling/edge cases are unclear.
Security and permissions 7/20
The server is designed to execute arbitrary AppleScript, which is inherently high-privilege, but no obvious malicious code or credential leaks are found. There is a remote SSH execution option requiring explicit credentials. A confirmation mechanism is lacking. Thus 7 is given because there is a risk of over-permission but no more severe security issues observed.
Maintenance 10/20
The repo is active with recent commits and releases, MIT license, and has CI and tests. However, release history and governance are unclear. Thus 10 is given because compared to active but governance gaps, this repo has clear code and test maintenance.
Documentation 9/20
README provides detailed install and usage examples including Node.js and Python approaches, Docker usage, and example prompts. But lacks troubleshooting and limitations. Thus 9 is given because docs are usable but have hidden assumptions.
Setup experience 10/20
Clear installation steps and client config examples are provided, including direct use of npx and uvx, and local development. But these are not verified. Thus 10 is given because the steps are simple and offer multiple configuration paths.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesWrites / deletes local filesRuns commands or codeChanges third-party account dataControls a browser

Best for

  • Users of Claude Desktop who want to control their Mac via natural language
  • Developers who need to automate common macOS tasks like managing calendar, notes, mail, and file system
  • Users who want a simple MCP server with minimal setup

Not for

  • Users who need remote execution without SSH setup (unless they configure SSH options)
  • Users who need platform-agnostic control (server only runs on macOS)
  • Production environments requiring advanced security sandboxing or auditing, since it allows arbitrary AppleScript execution

Required permissions

  • Ability to execute AppleScript code, which can access apps and data on the Mac
  • Access to file system (read/write files)
  • Ability to execute shell commands
  • Remote connection via SSH (if enabled)

Risks and side effects

  • Executing arbitrary AppleScript may make system changes, including deleting files, modifying settings, or sending messages
  • Access to sensitive data such as contacts, calendar, mail, and file contents
  • If used with SSH remote execution, credentials could be exposed, and remote control could be abused
  • AppleScript errors may cause unexpected behavior or system instability

Setup

Before you start

Runtime：Node.js · Python · Docker

### Install with Claude Desktop:

#### Node.js

Add to your Claude Desktop config:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": ["@peakmojo/applescript-mcp"]
    }
  }
}

#### Python (uvx)

No clone needed — run directly from the git repo:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/peakmojo/applescript-mcp", "mcp-server-applescript"]
    }
  }
}

#### Python (local development)

Clone the repo and use uv to run from source:

brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git

Then configure:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": ["--directory", "/path/to/your/repo", "run", "mcp-server-applescript"]
    }
  }
}

Check that it works

After configuring the client, the execute_applescript tool should appear in the tool list. Try a simple prompt like listing currently running applications to confirm the server works.

Troubleshooting

  1. Ensure AppleScript support is enabled on macOS (usually enabled by default)
  2. If using SSH remote execution, ensure Remote Login is enabled on your Mac (System Settings → Sharing → Remote Login) and provide correct username and password
  3. If using Docker, make sure to use `host.docker.internal` as the remote host in the config
  4. Check MCP server logs for error messages

Things to try

Once connected, you can ask your AI assistant things like:

  • 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
  • Take a screenshot of my entire screen and save it to my Desktop
  • Tell me how much free space I have on my main drive

Tools 1

execute_applescript destructive
Execute a piece of AppleScript code and return the result.

Use cases

Create reminders, e.g., 'Create a reminder for me to call John tomorrow at 10am'
Add meetings to calendar, e.g., 'Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"'
Create notes, e.g., 'Create a new note titled "Meeting Minutes" with today's date'
Find files, e.g., 'Show me all files in my Downloads folder from the past week'
Check system info, e.g., 'What's my current battery percentage?'
Manage applications, e.g., 'List all the currently running applications on my Mac'
Control media playback, e.g., 'Play my "Focus" playlist in Apple Music'
Take screenshots, e.g., 'Take a screenshot of my entire screen and save it to my Desktop'

Supported clients

Claude Desktop

Listed from the project's documentation, not tested by this site.

Overview

A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. It is intentionally designed to be simple, straightforward, intuitive, and require minimal setup. The core code is less than 100 lines. It supports running AppleScript to access Mac applications and data, e.g., 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 is supported via SSH.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →
Compare with other MCP servers

Source revision 2efc108111ce Data synced 2026-10-12 Read the FMRS scoring method