The AppleScript MCP Server allows you to run AppleScript code to interact with Mac applications and system features, including:
- Retrieve or create notes in Apple Notes
- Access or add calendar events and appointments
- List contacts or modify contact details
- Search for and organize files using Spotlight or Finder
- Get system information like battery status, disk space, or network details
- Access or send emails, messages, or other communications
- Read, write, or manage file contents
- Execute shell commands and capture the output
- Control media playback in applications like Apple Music
- Take screenshots
- Open applications and navigate to URLs
- Supports remote execution via SSH
Provides comprehensive access to macOS functionality through AppleScript, allowing interaction with the Mac operating system and its applications.
Enables control of Apple Music, including playing playlists as mentioned in the example prompt.
Provides access to the MCP server functionality through Node.js, allowing JavaScript-based interaction with macOS.
Provides access to the MCP server functionality through Python, offering an alternative programming interface for macOS automation.
Allows automation of Safari web browser, including opening the browser and navigating to websites.
Allows execution of shell commands on macOS, providing access to command-line utilities and system information.
Enables file searching using macOS Spotlight technology to locate files across the system.
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
Usage with Claude Desktop
Node.js
Python
Install uv
Run the server
Docker Usage
When running in a Docker container, you can use the special hostname host.docker.internal
to connect to your Mac host:
Configuration
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
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -484TypeScript
- -securityFlicense-qualityA Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.Last updated -4Python
- -securityFlicense-qualityA Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.Last updated -5Python
- -securityFlicense-qualityA Model Context Protocol server that provides greeting tools, resources, and prompts, demonstrating client-server interaction using TypeScript.Last updated -TypeScript