productivitydeveloper-tools

AppleScript▌

Name: AppleScript
Availability: InStock

by peakmojo

AppleScript MCP server lets AI execute apple script on macOS, accessing Notes, Calendar, Contacts, Messages & Finder via

Enables AI to execute AppleScript code on macOS systems, providing access to applications and system features like Notes, Calendar, Contacts, Messages, and Finder through a lightweight server implementation.

github stars

★ 431

GitHub npm

Under 100 lines of core codeWorks with remote execution via SSHDirect access to native Mac apps

best for

/ Mac users wanting AI automation of daily tasks
/ Productivity workflows involving Apple apps
/ System administration on macOS

capabilities

/ Execute AppleScript code on macOS
/ Access and modify Calendar events
/ Create and manage Notes entries
/ Search contacts and retrieve information
/ Control Mac applications via scripting
/ Search files using Spotlight or Finder

what it does

Lets AI assistants execute AppleScript commands to interact with Mac applications and system features like Notes, Calendar, Contacts, Messages, and Finder.

about

AppleScript is a community-built MCP server published by peakmojo that provides AI assistants with tools and capabilities via the Model Context Protocol. AppleScript MCP server lets AI execute apple script on macOS, accessing Notes, Calendar, Contacts, Messages & Finder via It is categorized under productivity, developer tools. This server exposes 1 tool that AI clients can invoke during conversations and coding sessions.

how to install

You can install AppleScript in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

AppleScript is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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

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 (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)

For local development, clone the repo and use uv to run from source:

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

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

Development

Setup

brew install uv
uv sync --dev

Run all checks (in parallel)

uv run check

This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.

Individual commands

uv run lint        # ruff linter
uv run format      # ruff auto-format
uv run typecheck   # pyrefly type checker
uv run test        # pytest with 100% coverage enforcement

Docker Usage

When running in a Docker container, you can use the special hostname host.docker.internal to connect to your Mac host:

Configuration

{
  "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:

SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
Your user has proper permissions
The correct credentials are provided in the config