applescript-mcp
MCP-сервер для macOS на AppleScript: календарь, почта, сообщения, заметки, Finder, iTerm и Команды под управлением агента
- 395 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает письма, переписку, заметки и буфер обмена, а это личные данные
- Сервер отправляет сообщения, запускает команды в iTerm и закрывает приложения
- Для работы нужны разрешения на автоматизацию и полный доступ к диску
Установка
- Работает в
Ручная установка
git clone https://github.com/joshrutkowski/applescript-mcp.git && cd applescript-mcp && npm install && npm run buildСборка из исходников: другого способа установки в документации нет. Результат лежит в dist/index.js.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает письма, переписку, заметки и буфер обмена, а это личные данные
- Сервер отправляет сообщения, запускает команды в iTerm и закрывает приложения
- Для работы нужны разрешения на автоматизацию и полный доступ к диску
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер позволяет агенту управлять Mac через AppleScript. Каждая команда запускает готовый скрипт через системную утилиту `osascript` и возвращает результат клиенту. Инструменты собраны в категории по приложениям и функциям. В Календаре агент создает событие и показывает сегодняшние. В Почте он готовит новое письмо, перечисляет письма ящика и находит нужное по теме, отправителю или дате. В Сообщениях доступны список чатов, чтение и поиск переписки и отправка: с автоотправкой или с открытием окна, где текст остается в черновике. Заметки создаются с простой разметкой или из HTML, а затем читаются и ищутся. В Pages агент создает документ с текстом. Остальные категории: буфер обмена, Finder с поиском файлов и быстрым просмотром, системные уведомления и режим «Не беспокоить», громкость, темная тема, запуск и закрытие приложений, запуск команд в iTerm и запуск Команд (Shortcuts) с входными данными. Архитектура модульная: новая категория добавляется отдельным файлом в `src/categories`.
Для кого. Для владельцев Mac, которые хотят командовать календарем, почтой, заметками и приложениями из диалога с агентом, и для разработчиков, расширяющих набор скриптов.
Подходит, если
- Нужно узнать события на сегодня или создать встречу в Календаре одной фразой
- Надо найти письмо по теме или отправителю в Почте и прочитать его
- Нужно сохранить итоги встречи в Заметках с заголовками и списками или найти старую заметку
- Хочется запускать свои Команды Shortcuts с входными данными из чата
- Нужно перебросить текст в буфер обмена, быстро просмотреть файл через Quick Look или запустить команду в iTerm
Не подходит, если
- Нужна Windows или Linux: сервер работает только на macOS 10.15 и новее
- Нужна работа с Safari и Напоминаниями: в документации они значатся как запланированные
- Агенту нельзя доверять письма, сообщения и команды терминала: сервер умеет отправлять сообщения и запускать команды в iTerm без отдельного режима только для чтения
Пример запроса к агенту
Какие события у меня сегодня в Календаре? Затем найди в Почте письмо от Сары про обновление проекта и сохрани его суть в заметку «Проект»MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
DEBUG- Значение applescript-mcp* включает подробные логи.
Ограничения
Документированный путь установки требует macOS 10.15 или новее, Node.js 18 и сборки из исходников. Проект давно не обновлялся: последний коммит в репозитории — апрель 2025. Лицензия MIT.
Разрешения на автоматизацию выдаются приложениям в настройках macOS, для чтения Сообщений нужен полный доступ к диску. Собственного подтверждения каждого вызова у сервера нет: он передает подготовленный AppleScript в `osascript`. Команды iTerm и автоотправку сообщений ограничивайте средствами клиента.
Прочитанные письма, заметки и переписка возвращаются агенту и могут попасть в облачную модель. Режим отладки добавляет сведения о скриптах и системе в журналы. Календарь умеет только создавать события и показывать сегодняшние.
Как отключить. Удалите запись `applescript-mcp-server` из файла `mcp.json` клиента и перезапустите клиент. Разрешения на автоматизацию и полный доступ к диску отзовите в системных настройках macOS, в разделе конфиденциальности. Удаление подключения не отменяет созданные события, документы и отправленные сообщения.
Частые вопросы
Как установить applescript-mcp и подключить к клиенту?
Клонируйте репозиторий, выполните `npm install` и `npm run build`, затем добавьте в `mcp.json` сервер с командой `node` и аргументом `/path/to/applescript-mcp/dist/index.js`. Готового пакета для `npx` в документации нет.
Какие приложения macOS может контролировать applescript-mcp?
Календарь, Почту, Сообщения, Заметки, Pages, Finder, iTerm и Команды, а еще буфер обмена, системные уведомления и настройки: громкость, темную тему, запуск и закрытие приложений. Safari и Напоминания указаны как запланированные.
Почему не приходят уведомления от applescript-mcp?
Уведомления отправляет Script Editor, поэтому включите их для него в Системных настройках, в разделе «Уведомления». Без этого `send_notification` ничего не покажет.
Как дать applescript-mcp доступ к Сообщениям?
Сообщения читаются из базы данных, поэтому клиенту нужен полный доступ к диску. Остальные приложения требуют разрешения на автоматизацию в разделе «Конфиденциальность и безопасность».
Может ли агент сам отправить сообщение или письмо через applescript-mcp?
Сообщение может, письмо нет. Сообщение отправит инструмент `compose_message` с параметром `auto=true`, а без него Сообщения открываются с заполненным текстом, и отправляет его человек. Инструмент `create_email` только создает черновик письма в Почте.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для AppleScript: агент запускает скрипты и управляет приложениями Mac, от заметок и календаря до файлов
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
MCP-сервер для macOS: агент двигает мышь, печатает, управляет окнами и снимает экран, когда у приложения нет API
MCP-сервер для управления Windows: агент открывает приложения, кликает и печатает, читает состояние окон и интерфейса, работает с файлами и PowerShell
MCP-сервер на Node.js, через который агент управляет устройствами Home Assistant и правит его автоматизации
MCP-сервер помогает агенту создавать и проверять Python-задачи для управления приложениями Windows и устройствами Android.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| applescript-mcp (эта карточка) | нет | не нужна | 395 | |
| AppleScript MCP Server | нет | не нужна | 466 | запускает произвольные AppleScript, которые составляет агент, без готовых категорий |
| MCP iCal Server | нет | не нужна | 333 | узкий сервер только для календаря macOS с созданием, поиском и правкой событий |
Коротко о README
Категории представлены отдельными TypeScript-модулями. Если нужного действия нет, разработчик может добавить скрипт и его параметры, затем пересобрать сервер. Готовые инструменты работают через системный AppleScript.