applescript-mcp MCP — Сценарии использования, Установка & Живое демо

Name: applescript-mcp MCP Server
Author: peakmojo

Зачем использовать

Ключевые функции

Execute any AppleScript command and return results to Claude
Control Notes, Calendar, Contacts, Messages, Finder, and other macOS apps
Spotlight file search and Finder operations
System info retrieval — battery, disk space, screenshots
Remote execution via SSH for Docker setups

Живое демо

Как выглядит на практике

applescript-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "applescript-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "applescript-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/peakmojo/applescript-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add applescript-mcp -- TODO 'See README: https://github.com/peakmojo/applescript-mcp'

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: applescript-mcp

How to create calendar events with natural language using applescript-mcp

👤 Mac users who want to manage their calendar via Claude ⏱ ~5 min beginner

Когда использовать: You want to quickly create, modify, or query calendar events without opening Calendar.app.

Предварительные требования

macOS with SSH enabled — System Settings → Sharing → Remote Login
applescript-mcp installed — npx -y @peakmojo/applescript-mcp or uvx applescript-mcp

Поток

Create an event

Create a calendar event titled 'Team Standup' for tomorrow at 10am, 30 minutes long, in my Work calendar.✓ Скопировано

→ Confirmation that the event was created with date and time
Query upcoming events

What events do I have this week?✓ Скопировано

→ List of calendar events with times and titles

Итог: Calendar events created and queried without leaving the chat.

Подводные камни

AppleScript uses calendar names that must match exactly — List available calendars first before creating events

Сочетать с: filesystem

Search and organize files on your Mac with applescript-mcp

👤 Mac power users looking for file management automation ⏱ ~10 min intermediate

Когда использовать: You need to find scattered files across your Mac and organize them.

Предварительные требования

applescript-mcp running — npx -y @peakmojo/applescript-mcp

Поток

Search for files

Use Spotlight to find all PDF files on my Mac modified in the last week.✓ Скопировано

→ List of file paths matching the criteria
Organize results

Move all those PDFs into ~/Documents/Recent-PDFs/, creating the folder if needed.✓ Скопировано

→ Confirmation of files moved

Итог: Files found via Spotlight and organized into a designated folder.

Подводные камни

Spotlight index may be incomplete — Ensure Spotlight indexing is enabled for the relevant drives in System Settings

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

applescript-mcp + filesystem

Use AppleScript to find files via Spotlight, then filesystem MCP to read and process their contents

Find all .md files modified today using Spotlight, then read and summarize each one.✓ Скопировано

applescript-mcp + github

Create calendar reminders for upcoming GitHub PR review deadlines

Check my open PR review requests on GitHub and create calendar reminders for any that are overdue.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
run_applescript	script: str	Execute any AppleScript command on the connected Mac	0

Стоимость и лимиты

Во что обходится

Квота API: No external API — runs locally on macOS
Токенов на вызов: 200–1000 tokens per script execution
Деньги: Free
Совет: Keep scripts focused on one task per call to minimize token usage from large outputs.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: SSH credentials needed for remote execution — store in env vars, not in config files

Исходящий трафик: All execution is local to the Mac. No external network calls unless your script makes them.

WARNING: This MCP grants full system control via AppleScript. It can read/write files, send messages, execute shell commands, and control any application. Only use with trusted prompts and review scripts before execution.
Never run this on a production machine or with access to sensitive data you wouldn't want an AI to process.
SSH remote execution exposes the target Mac to any command the AI generates. Use strong credentials and restrict network access.

Устранение неполадок

Частые ошибки и исправления

AppleScript execution failed — not authorized

Grant Terminal (or your MCP host) access in System Settings → Privacy & Security → Automation and Accessibility.

Проверить: osascript -e 'tell application "Finder" to get name of every disk'

SSH connection refused

Enable Remote Login in System Settings → Sharing. Verify SSH credentials are correct.

Проверить: ssh your-user@localhost 'echo ok'

Application not responding to AppleScript

Some apps have limited or no AppleScript support. Check the app's AppleScript dictionary in Script Editor.

Проверить: Open Script Editor → File → Open Dictionary → select the app

Альтернативы

applescript-mcp в сравнении

Альтернатива	Когда использовать	Компромисс
filesystem MCP	You only need file read/write without controlling macOS apps	Much narrower scope but no system-level access risks

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills