# Mac Shortcuts — read your Mac from any agent

Открывает агенту доступ к системным приложениям macOS через быстрые команды Apple. Позволяет читать заметки, календарь, напоминания и контакты без внешних серверов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Автор: Dominic-DK
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Dominic-DK/mac-shortcuts-mcp
- Обновлён: 2026-09-21
- HTML: https://affpapa.org/nevibecode/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. При заблокированном экране запросы выполняются штатно, но в спящем режиме фоновые процессы операционной системы замирают, из-за чего сервер перестаёт отвечать до пробуждения компьютера.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mac-shortcuts-mcp -- npx -y mac-shortcuts-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add mac-shortcuts-read-your-mac-from-any-agent -- npx -y mac-shortcuts-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mac-shortcuts-read-your-mac-from-any-agent": {
            "command": "npx",
            "args": [
                "-y",
                "mac-shortcuts-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mac-shortcuts-read-your-mac-from-any-agent": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mac-shortcuts-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mac-shortcuts-read-your-mac-from-any-agent npx -y mac-shortcuts-mcp
```

## Когда брать
- найти телефон или адрес человека в системных контактах
- проверить расписание встреч в календаре на ближайшие дни
- прочитать текст конкретной записи из приложения «Заметки»
- узнать уровень заряда батареи и статус текущего воспроизведения
- сверить точные параметры действий в каталоге команд Shortcuts

## Примеры запросов агенту
- Что у меня запланировано в календаре на эту неделю?
- Найди в моих заметках текст договора аренды
- Посмотри номер телефона Анны в контактах

## Похожие
- [Apple Shortcuts Integration](https://affpapa.org/nevibecode/skills/apple-shortcuts-integration.md) — скилл · 4700 установок
- [intents-mcp](https://affpapa.org/nevibecode/mcp/intents-mcp.md) — MCP-сервер · ★ 6
- [Apple Calendar](https://affpapa.org/nevibecode/mcp/apple-calendar.md) — MCP-сервер · ★ 31
- [cmux-keyboard-shortcuts](https://affpapa.org/nevibecode/skills/cmux-keyboard-shortcuts.md) — скилл · 6200 установок
- [Apple Shortcuts](https://affpapa.org/nevibecode/mcp/apple-shortcuts.md) — MCP-сервер · ★ 31
- [mac-control-mcp](https://affpapa.org/nevibecode/mcp/mac-control-mcp.md) — MCP-сервер · ★ 18

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md