MCP server AppleScript
Позволяет ИИ-клиенту запускать AppleScript на Mac для управления приложениями, файлами, напоминаниями, календарями, сообщениями и shell-командами.
Также известен как peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Звёзды
- 468
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 22 февр. 2026 г.
- Лицензия
- MIT
Что такое AppleScript MCP?
AppleScript — это MCP server. Позволяет ИИ-клиенту запускать AppleScript на Mac для управления приложениями, файлами, напоминаниями, календарями, сообщениями и shell-командами.
Сводка сгенерирована из README проекта
О AppleScript MCP server
С помощью этого MCP server можно управлять приложениями macOS и системными данными через ИИ-клиент. Он позволяет пользователям выполнять AppleScript для управления файлами, напоминаниями, календарями, сообщениями и заметками прямо из интерфейса чата. Соединяя языковые модели с операционной системой Mac, он обеспечивает автоматизацию взаимодействия с нативными приложениями, такими как Apple Music, Safari и Contacts.
Разработчики могут настроить его локально, используя Node.js через npx или Python через uvx. Для тех, кто работает в Docker-контейнерах, сервер поддерживает удаленное выполнение через SSH путем подключения к хост-машине. Для этого потребуется включить Remote Login в системных настройках Mac и предоставить необходимые учетные данные пользователя. Сервер предоставляет возможность выполнять системные задачи, такие как проверка уровня заряда батареи, поиск файлов через Spotlight или запуск shell-команд.
Что вы можете с ним делать
- 1Управление личными расписаниями и задачамиПопросите ИИ добавить новые встречи в календарь или создать определенные напоминания.
- 2Организация и поиск локальных файловПопросите ИИ найти конкретные файлы в ваших папках или создать новые директории на рабочем столе.
- 3Управление медиа и системными настройкамиДайте ИИ команду воспроизвести определенные музыкальные плейлисты или проверить состояние оборудования.
- 4Автоматизация общения и поиск контактовИспользуйте ИИ, чтобы найти номера телефонов в ваших контактах или проверить непрочитанные сообщения.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить AppleScript MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка AppleScript MCP в Claude Code
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpУстановка AppleScript MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Установка AppleScript MCP в VS Code
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Установка AppleScript MCP в VS Code CLI
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Установка AppleScript MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Установка AppleScript MCP в Codex
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpУстановка AppleScript MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Установка AppleScript MCP в Gemini CLI
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpУстановка AppleScript MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийpeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источник@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @peakmojo/applescript-mcpПройдено
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubAppleScript 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
Вопросы о AppleScript MCP
Как добавить AppleScript MCP в Claude Code?
Выполните claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить AppleScript MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Что может делать AppleScript MCP server на моем Mac?
Он выполняет код AppleScript для взаимодействия с приложениями и данными Mac, включая Notes, Calendar, Contacts, Messages, файлы и shell-команды.
Как установить AppleScript MCP server в Claude Desktop?
Добавьте его как MCP server через npx, используя пакет @peakmojo/applescript-mcp, или запустите Python-версию через uvx из git-репозитория.
Можно ли использовать его внутри Docker-контейнера?
Да, используя hostname host.docker.internal вместе с аргументами remote host, user и password при включенном SSH на Mac.
Поддерживает ли он удаленное выполнение?
Да, удаленное выполнение поддерживается через SSH с указанием удаленного хоста, пользователя и пароля.
Какой инструмент командной строки нужен для Python-версии?
Python-версия запускается через uv, который можно установить с помощью Homebrew.