Use This MCP server To

Automate Mac app interactions using AppleScript commands Create and manage reminders, calendar events, and contacts Search and manipulate files via Spotlight or Finder Read and write file contents on Mac programmatically Execute shell commands on Mac through MCP Integrate Mac system control into AI-driven workflows Trigger Mac automation tasks from natural language prompts

README

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

npm version License: 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.

applescript.mcp.demo.0422.mp4

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

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

{
  "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"
      ]
    }
  }
}

applescript-mcp FAQ

How do I install the applescript-mcp server?

Install via npm with '@peakmojo/applescript-mcp' and follow GitHub setup instructions.

What Mac applications can applescript-mcp control?

It can control Notes, Calendar, Contacts, Messages, and more via AppleScript.

Is the applescript-mcp server compatible with Python and Node.js?

Yes, it supports dual access from both Python and Node.js environments.

How secure is running AppleScript through this MCP server?

The server runs locally on your Mac, giving you full control and security over script execution.

Can I execute shell commands using applescript-mcp?

Yes, it supports executing shell commands alongside AppleScript for extended control.

Does applescript-mcp require complex configuration?

No, it is designed to be simple and intuitive with minimal setup required.

Can I use applescript-mcp to automate file searches?

Yes, it can search files using Spotlight or Finder through AppleScript.

What LLM providers can I integrate with applescript-mcp?

You can integrate with OpenAI, Anthropic Claude, and Google Gemini models.