applescript-mcp

# AppleScript MCP Server (Dual access: python and node.js) [](https://www.npmjs.com/package/@peakmojo/applescript-mcp) [](https://opensource.org/licenses/MIT) ## 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. <a href="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp/badge" alt="AppleScript Server MCP server" /> </a> 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 ### Node.js ```json { "mcpServers": { "applescript_execute": { "command": "npx", "args": [ "@peakmojo/applescript-mcp" ] } } } ``` ### Python 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: ### Configuration ```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