Apple Notes · mgcrea — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для чтения и ведения заметок в приложении Apple Notes на macOS. Позволяет агенту искать папки, просматривать записи и создавать новые документы.
claude mcp add --env APPLE_NOTES_ALLOW_WRITES=<APPLE_NOTES_ALLOW_WRITES> --env APPLE_NOTES_ACCOUNTS=<APPLE_NOTES_ACCOUNTS> --transport stdio notes -- npx -y @mgcrea/mcp-apple-notesЧто делает Apple Notes
Сервер работает с приложением Apple Notes на Mac через две ветки: события Apple Events и прямое чтение базы NoteStore.sqlite. Базовый режим не требует доступа ко всему диску — агент управляет заметками через Apple Events, а полнотекстовый поиск по библиотеке из 921 записи занимает 97 ms. Предел этого режима наступает около 5–10k заметок, когда прямой доступ к SQLite-индексу становится быстрее.
По умолчанию функции изменения отключены. Инструменты вроде create_note и delete_notes физически скрыты от модели, пока переменная APPLE_NOTES_ALLOW_WRITES не выставлена в 1. Защищённые паролем заметки прочитать не выйдет: их текст зашифрован алгоритмом AES и недоступен ни при каких разрешениях. Без выдачи прав Automation на управление Notes в macOS сервер завершится с ошибкой -1743.
Какие задачи решает
- находить заметки по ключевым словам и выгружать вложения
- создавать новые записи в системных папках macOS Notes
- перемещать и удалять устаревшие заметки через агента
- получать списки аккаунтов и вложенных папок
Примеры запросов агенту
- Найди в Apple Notes все заметки со словом roadmap за прошлую неделю.
- Создай новую заметку в папке Work с заголовком План релиза.
- Сохрани вложения из заметки с отчётом в папку
~/Downloads.
Как установить Apple Notes
Командой платформы
claude mcp add --env APPLE_NOTES_ALLOW_WRITES=<APPLE_NOTES_ALLOW_WRITES> --env APPLE_NOTES_ACCOUNTS=<APPLE_NOTES_ACCOUNTS> --transport stdio notes -- npx -y @mgcrea/mcp-apple-notesВместо <…> подставьте свои значения
Командой платформы
codex mcp add notes --env APPLE_NOTES_ALLOW_WRITES=<APPLE_NOTES_ALLOW_WRITES> --env APPLE_NOTES_ACCOUNTS=<APPLE_NOTES_ACCOUNTS> -- npx -y @mgcrea/mcp-apple-notesВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"notes": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
],
"env": {
"APPLE_NOTES_ALLOW_WRITES": "<APPLE_NOTES_ALLOW_WRITES>",
"APPLE_NOTES_ACCOUNTS": "<APPLE_NOTES_ACCOUNTS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
],
"env": {
"APPLE_NOTES_ALLOW_WRITES": "<APPLE_NOTES_ALLOW_WRITES>",
"APPLE_NOTES_ACCOUNTS": "<APPLE_NOTES_ACCOUNTS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_NOTES_ALLOW_WRITES=<APPLE_NOTES_ALLOW_WRITES> -e APPLE_NOTES_ACCOUNTS=<APPLE_NOTES_ACCOUNTS> notes npx -y @mgcrea/mcp-apple-notesВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Notes
Как установить Apple Notes в Claude Code?
Выполните команду claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes. Если нужны права на изменение записей, передайте переменные окружения: `claude mcp add --env APPLE_NOTES_ALLOW_WRITES=<APPLE_NOTES_ALLOW_WRITES> --env APPLE_NOTES_ACCOUNTS=<APPLE_NOTES_ACCOUNTS> --transport stdio notes -- npx -y @mgcrea/mcp-apple-notes`.
Что делает Apple Notes?
Сервер подключает Claude Code к локальной базе Apple Notes на macOS, открывая агенту поиск по папкам, просмотр текста записей и выгрузку вложений.
Почему сервер не может прочесть заметки под паролем?
Защищённые записи хранятся на диске как шифротекст AES. Системные права доступа не снимают шифрование, поэтому сервер физически не может передать их содержимое модели.
Похожие MCP-серверы
Все MCP-серверы по теме «Заметки, задачи и проекты» →Сначала — Apple Notes от других авторов.
