Обзор

Сервер Model Context Protocol (MCP), который позволяет запускать код AppleScript для взаимодействия с Mac. Этот MCP специально разработан так, чтобы быть простым, понятным, интуитивно понятным и требовать минимальной настройки.

Не могу поверить, насколько это просто и мощно. Основной код —

https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388

Особенности

• Запустите AppleScript для доступа к приложениям и данным Mac
• Взаимодействуйте с заметками, календарем, контактами, сообщениями и другим
• Поиск файлов с помощью Spotlight или Finder
• Чтение/запись содержимого файлов и выполнение команд shell
• Поддержка удалённого выполнения через SSH

Примеры запросов

Использование с Claude Desktop

Node.js

Python (uvx)

Клон не нужен — запускайте напрямую из git репозитории:

Python (локальная разработка)

Для локальной разработки клонируйте репозиторий и используйте uv для запуска от источника:

Развитие

Подготовка

Проведите все проверки (параллельно)

Он выполняет подкладку, форматирование, проверку типов и тесты с 100% покрытием — всё это параллельно.

Индивидуальные команды

Использование в Docker

При работе в контейнере Docker вы можете использовать специальное имя хоста host.docker.internal для подключения к вашему Mac-хосту:

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