Mac Shortcuts — MCP-сервер для Claude Code
Открывает агенту доступ к системным приложениям macOS через быстрые команды Apple. Позволяет читать заметки, календарь, напоминания и контакты без внешних серверов.
claude mcp add mac-shortcuts-mcp -- npx -y mac-shortcuts-mcpЧто делает Mac Shortcuts — read your Mac from any agent
У ИИ-агентов нет системных разрешений для чтения данных из закрытых программ macOS вроде Заметок или Календаря. Этот сервер передаёт обращения приложению Shortcuts.app, которое уже обладает нужными правами, и возвращает ответ в виде простого текста. Чтобы защититься от внедрения промптов, полученные записи помечаются именно как данные, а не системные инструкции.
Встроенный каталог включает чтение событий календаря, списков напоминаний, контактов, геопозиции, погоды, буфера обмена и текущего аудиотрека. В дистрибутив также входит файл action-catalog.json, описывающий 539 действий из системного реестра macOS 27 с их точными параметрами. Инструмент mac_run_shortcut умеет вызывать любые ваши команды, поэтому строгой изоляции исключительно в режиме чтения здесь нет.
Для работы понадобится выполнить первичную команду настройки npx -y mac-shortcuts-mcp setup, которая подпишет рецепты прямо на устройстве и предложит добавить их через диалоги Shortcuts.app. Сервер функционирует локально и рассчитан только на macOS. При заблокированном экране запросы выполняются штатно, но в спящем режиме фоновые процессы операционной системы замирают, из-за чего сервер перестаёт отвечать до пробуждения компьютера.
Какие задачи решает
- найти телефон или адрес человека в системных контактах
- проверить расписание встреч в календаре на ближайшие дни
- прочитать текст конкретной записи из приложения «Заметки»
- узнать уровень заряда батареи и статус текущего воспроизведения
- сверить точные параметры действий в каталоге команд Shortcuts
Примеры запросов агенту
- Что у меня запланировано в календаре на эту неделю?
- Найди в моих заметках текст договора аренды
- Посмотри номер телефона Анны в контактах
Как установить Mac Shortcuts — read your Mac from any agent
Командой платформы
claude mcp add mac-shortcuts-mcp -- npx -y mac-shortcuts-mcpКомандой платформы
codex mcp add mac-shortcuts-read-your-mac-from-any-agent -- npx -y mac-shortcuts-mcpФайл настроек
{
"mcpServers": {
"mac-shortcuts-read-your-mac-from-any-agent": {
"command": "npx",
"args": [
"-y",
"mac-shortcuts-mcp"
]
}
}
}Файл настроек
{
"servers": {
"mac-shortcuts-read-your-mac-from-any-agent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mac-shortcuts-mcp"
]
}
}
}Командой платформы
gemini mcp add mac-shortcuts-read-your-mac-from-any-agent npx -y mac-shortcuts-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Mac Shortcuts — read your Mac from any agent
Как установить Mac Shortcuts в Claude Code?
Сначала выполните в терминале команду настройки npx -y mac-shortcuts-mcp setup и подтвердите импорт рецептов. Затем подключите сервер командой claude mcp add mac-shortcuts-mcp -- npx -y mac-shortcuts-mcp.
Что делает MCP-сервер Mac Shortcuts?
Он передаёт запросы агента приложению Shortcuts.app на macOS, возвращая текст из календаря, заметок, напоминаний, контактов и буфера обмена. Все полученные записи размечаются как данные, а не системные инструкции.
Работает ли сервер, когда Mac заблокирован или спит?
При заблокированном экране запросы выполняются без задержек. Однако в спящем режиме фоновые процессы macOS останавливаются, поэтому сервер не сможет ответить агенту до пробуждения устройства.
