Apple Notes MCP
MCP-сервер для Apple Notes на Mac: агент читает, ищет, создает, правит и выгружает заметки, управляет папками и тегами.
- 187 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает и меняет все заметки, а для чтения базы требует Full Disk Access.
- Необязательный посредник разрешений открывает возможности Notes всем процессам учетной записи.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/apple-notes-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает и меняет все заметки, а для чтения базы требует Full Disk Access.
- Необязательный посредник разрешений открывает возможности Notes всем процессам учетной записи.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Apple Notes MCP — локальный сервер, который соединяет ИИ-ассистента с приложением «Заметки» на macOS. Запускается по stdio на том же Mac, где хранится библиотека заметок. Через AppleScript, подписанные Apple Shortcuts и чтение базы данных без записи он читает, ищет, создает, меняет, перемещает и удаляет заметки и папки, работает с учетными записями, нативными тегами, чек-листами, таблицами, закрепленными заметками, ссылками и вложениями. Заметки выгружаются в Markdown по шаблонам, которые правят в локальном веб-редакторе. Есть пакетные операции, диагностика `doctor` и `get-capabilities`, которая показывает, какие возможности доступны на вашей версии macOS. Для Claude Code есть плагин с встроенным сервером и скиллом, для Codex и Antigravity лежат отдельные манифесты, ручная регистрация идет через `npx -y apple-notes-mcp@latest`. Заметки с паролем сервер не читает.
Для кого. Пользователям Mac, которые ведут дела в Apple Notes и хотят поручить Claude Code или Codex поиск, сводки и наведение порядка в заметках.
Подходит, если
- Итог переписки сохраняют отдельной заметкой в нужной папке.
- По слову находят все заметки о сроке проекта и просят сводку.
- Черновики переносят в архивную папку пакетной командой.
- Заметку выгружают в Markdown по своему шаблону.
Не подходит, если
- Работа идет не на Mac: сервер использует AppleScript и приложение Notes.
- Заметки защищены паролем: сервер не может их читать или менять.
- Нельзя дать агенту доступ к Full Disk Access и автоматизации Notes.
Пример запроса к агенту
Найди заметки про дедлайн проекта, сделай краткую сводку и сохрани ее новой заметкой в папку Work.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны macOS с настроенной учетной записью Notes, Node.js 20 и новее и разрешение на управление Notes.app. Для чтения из базы нужен Full Disk Access, а нативные теги, чек-листы и таблицы работают через Shortcuts только с macOS 13. Создание заметок из Markdown через нативный мост требует macOS 26 и учетной записи iCloud. Дополнительный посредник разрешений открывает возможности Notes всем процессам под вашей учетной записью, включайте его осознанно. Описание сверено с версией 2.15.1.
Как отключить. Удалите плагин через менеджер плагинов клиента или выполните `claude mcp remove apple-notes`. Уберите выданные Full Disk Access и автоматизацию в настройках приватности macOS и удалите импортированные Shortcuts.
Частые вопросы
Как проверить, что работает на моей версии macOS?
Вызовите `get-capabilities`: для каждой возможности он показывает минимальную версию macOS и причину недоступности, например `requires_macos_13`.
Нужен ли пароль Apple ID или ключ API?
Нет. Сервер не хранит паролей и токенов, ему нужны только разрешения macOS на управление Notes и при необходимости Full Disk Access.
Что такое посредник разрешений?
Необязательный процесс, который держит Full Disk Access и автоматизацию Notes для сервера. Он доступен всем процессам вашей учетной записи, поэтому включайте его только при необходимости.
Как поставить для Codex?
Выполните `codex mcp add apple-notes -- npx -y apple-notes-mcp@latest`. Не регистрируйте одновременно плагин и ручную запись: серверы задвоятся.
Можно ли читать голосовые заметки?
Для вложенных записей есть `transcribe-note-audio` с расшифровкой на устройстве и `get-audio-transcripts` для сохраненных расшифровок. Нужны вспомогательная программа и Full Disk Access.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыSimplenote MCP — заметки Simplenote в агенте
simplenote-mcp
Официальный MCP-сервер Simplenote от Automattic: агент читает, ищет и по желанию правит заметки, на macOS работает без входа
Apple Books MCP — ваши книги и заметки в Claude
Apple Books MCP
MCP-сервер для Apple Books на macOS: агент видит текущую книгу, читает главы, выделения и заметки, ищет книги
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
Локальный MCP-сервер для Mac: Claude, Codex и ChatGPT работают в приложениях, файлах, терминале и браузере по разрешениям
Заметки для iPhone и Mac, которые Claude, Claude Code, Codex и ChatGPT читают и правят по MCP, с откатом правок ИИ
MCP-сервер заметок Joplin: ассистент ищет, создает, правит, помечает тегами и восстанавливает заметки из корзины.
Коротко о README
Покрывает папки, нативные теги, чек-листы, таблицы и экспорт Markdown, а возможности подбираются под версию macOS.