Для чего этот сервер?

Этот MCP-сервер подключает Apple Notes к любым MCP-совместимым клиентам — например, Claude Desktop или Continue.dev. Он берёт на себя всю работу с заметками через AppleScript: создание, чтение, редактирование, удаление, поиск и управление папками. Вместо того чтобы вручную открывать приложение и копаться в заметках, разработчик или пользователь может поручить AI-ассистенту находить нужную информацию, структурировать записи или вести документацию прямо через чат. Сервер решает проблему автоматизации Apple Notes, которая раньше была доступна только через сложные скрипты.

Что он умеет?

Сервер создаёт и редактирует заметки с HTML-форматированием, читает и удаляет их по ID, перемещает между папками. Управляет папками — создаёт, переименовывает, удаляет, перемещает, показывает иерархию папок и заметок. Ищет заметки по ключевым словам, выводит полный список всех заметок.

henilcalagiya/mcp-apple-notes — MCP-сервер

create_folder

Создать папку в Apple Notes. Возможности: - Создаёт папки на корневом уровне или во вложенных путях (до 5 уровней вложенности) - Поддерживает Unicode и эмодзи для международных символов - Обнаруживает дублирующиеся имена и проводит полную проверку - Поддерживает учётную запись iCloud - Создаёт папку только если родительский путь существует Проверка: - Максимум 128 символов, запрещены спецсимволы: < > : " | ? * - Родительские пути должны существовать, запрещает дубликаты - Выдаст ошибку, если родительский путь не существует

Параметры

folder_namestringобязательный
Name of the folder to create (1-128 chars, no < > : " | ? *)
folder_pathstring
Optional nested path (e.g., 'Work/Projects'). If empty, creates at root level. Max 5 levels deep.

create_note

Создаёт новую заметку с указанным названием и содержимым. Поддерживаемый HTML: <h1-h6>, <b><i><u>, <p><div><br>, <ul><ol><li>, <table>, <a> Рекомендации: используйте семантический HTML, добавляйте <br> для отступов, избегайте CSS-стилей Папки: корневой уровень или вложенные пути (до 5 уровней вложенности) Ограничения: в имени недопустимы спецсимволы, CSS/JS — только базовый Пример: name: "<h1>Project Report</h1>" body: "<p>Status: <b>In Progress</b></p><br><ul><li>Task 1</li></ul>"

Параметры

namestringобязательный
Note title wrapped in <h1> tags (e.g., '<h1>My Note Title</h1>')
bodystringобязательный
Note body content with appropriate HTML formatting (e.g., '<p>Content here</p>'). For proper spacing between two sections, use <br>.
folder_pathstring
Target folder path (e.g., 'Work' or 'Work/Projects/2024'). Defaults to 'Notes'

delete_folder

Удаляет папку в Apple Notes по ID с подтверждением через AppleScript. ФУНКЦИИ БЕЗОПАСНОСТИ: - Проверяет, существует ли папка с указанным ID - Подтверждает, что имя папки совпадает, перед удалением - Использует первичный ключ ID для точной идентификации - AppleScript автоматически проверяет ID и имя - Выдаёт подробные сообщения об ошибках для диагностики ВЫВОД: - Имя папки, ID, статус удаления и информацию о методе

Параметры

folder_idstringобязательный
Primary key ID of the folder to delete (e.g., 'p2330')
folder_namestringобязательный
Name of the folder to verify and delete

delete_note

Удаляет заметку по её первичному ключу с проверкой через AppleScript. Функции безопасности: - Проверяет, что заметка с указанным ID существует - Подтверждает совпадение имени заметки перед удалением - Использует ID первичного ключа для точной идентификации - AppleScript автоматически проверяет ID и имя - Выдаёт подробные сообщения об ошибках для отладки Вывод: - Имя заметки, ID, статус удаления и информацию о методе

Параметры

note_idstringобязательный
Primary key ID of the note to delete (e.g., 'p1308')
note_namestringобязательный
Name of the note to verify and delete

list_all_notes

Выводит список всех заметок во всех папках с их названиями и идентификаторами. Возможности: - Перечисляет ВСЕ заметки из ВСЕХ папок в Apple Notes - Показывает названия заметок, идентификаторы и расположение папок - Включает заметки из папки «Недавно удалённые» - Предоставляет полный обзор системы Формат вывода: - Нумерованный список всех заметок - Названия заметок с эмодзи-индикаторами - Идентификаторы заметок для ссылок - Расположение папки для каждой заметки Возвращает: Полный список всех заметок во всех папках Apple Notes

Параметры

Без параметров.

list_folder_with_structure

Выводит полную структуру папок в формате иерархического дерева. Возможности: - Показывает все папки в виде иерархического дерева - Отображает уровни вложенности папок с визуальными индикаторами - Работает с корневым уровнем и вложенными структурами папок Формат вывода: - Структура дерева с индикаторами ├── и └── - Чёткая визуализация иерархии - Названия папок с правильным отступом Возвращает: Иерархическую структуру дерева всех папок в Apple Notes

Параметры

Без параметров.

list_notes_with_structure

Выводит полную структуру папок с заметками в виде иерархического дерева. Возможности: - Показывает все папки и заметки в виде иерархического дерева - Отображает уровни вложенности папок с визуальными обозначениями - Перечисляет заметки внутри каждой папки - Работает с корневым уровнем и вложенными структурами папок Формат вывода: - Древовидная структура с обозначениями ├── и └── - Имена папок с правильным отступом - Заметки, перечисленные под соответствующими папками Возвращает: Иерархическую древовидную структуру всех папок и заметок в Apple Notes

Параметры

Без параметров.

move_folder

Перемещает папку из одного места в другое в Apple Notes по ID с проверкой через AppleScript. Возможности: - Перемещает папки по ID с верификацией через AppleScript - Полная валидация и обнаружение дубликатов - Поддержка Unicode и эмодзи в именах папок - Работает как с корневым уровнем, так и с вложенными путями Проверки: - Проверяет, существует ли целевой путь - Запрещает дублирование имён в целевой папке - Ограничивает глубину вложенности до 5 уровней - AppleScript проверяет, что ID и имя принадлежат одной и той же папке

Параметры

folder_idstringобязательный
Primary key ID of the folder to move (e.g., 'p2330')
folder_namestringобязательный
Name of the folder to verify and move
target_pathstring
Target path where to move the folder (e.g., 'Archive'). If empty, moves to root level.

move_note

Перемещает заметку из одной папки в другую в Apple Notes по ID с проверкой через AppleScript. Возможности: - Переносит заметки между корневыми папками и вложенными путями (до 5 уровней) - Полная проверка и обработка ошибок - Поддерживает все типы путей к папкам (корневые, простые, вложенные) - Сохраняет содержимое и метаданные заметки при перемещении - AppleScript проверяет совпадение ID и имени перед перемещением Требования: - Заметка с указанным ID и именем должна существовать - Целевой путь к папке должен существовать - AppleScript выполняет всю проверку автоматически

Параметры

note_idstringобязательный
Primary key ID of the note to move (e.g., 'p1308')
note_namestringобязательный
Name of the note to verify and move
target_folder_pathstringобязательный
Target folder path where to move the note (e.g., 'Archive' or 'Work/Completed')

read_folder

Читает папку по её primary key ID с проверкой AppleScript. Функции безопасности: - Проверяет, что папка существует с указанными ID и именем - Использует primary key ID для точной идентификации - Возвращает подробную информацию о папке с содержимым Вывод: - Метаданные папки (имя, ID, даты создания и изменения) - Непосредственные вложенные папки (имена и ID) - Заметки в папке (имена и ID) - Сводные подсчёты

Параметры

folder_idstringобязательный
Primary key ID of the folder to read (e.g., 'p2330')
folder_namestringобязательный
Name of the folder to verify and read

read_note

Читает заметку по первичному ключу ID с проверкой через AppleScript. Безопасность: - Проверяет, что заметка с указанным ID и именем существует - Использует первичный ключ ID для точной идентификации - Возвращает полное содержимое заметки с метаданными Вывод: - Имя заметки, ID, папка, даты создания и изменения - Полное содержимое (заголовок + тело) - Статус и информация о методе чтения

Параметры

note_idstringобязательный
Primary key ID of the note to read (e.g., 'p1308')
note_namestringобязательный
Name of the note to verify and read

rename_folder

Переименовывает папку в Apple Notes по ID с усиленной проверкой имени. Возможности: - Переименовывает папки по ID с двойной проверкой имени - Полная валидация и обнаружение дубликатов - Поддержка Unicode и эмодзи в именах папок - Работает с корневым уровнем и вложенными путями Проверки: - Максимум 128 символов, запрещены символы: < > : " | ? * - Предотвращает дублирование имён в одном расположении - Новое имя не может совпадать с текущим - Проверяет, что ID папки соответствует текущему имени (двойная проверка) - Получает фактическое имя папки по ID для дополнительной безопасности

Параметры

folder_idstringобязательный
Primary key ID of the folder to rename (e.g., 'p2330')
current_namestringобязательный
Current name of the folder to verify and rename
new_namestringобязательный
New name for the folder (1-128 chars, no < > : " | ? *)

search_notes

Ищет заметки, содержащие указанные ключевые слова. Возможности: - Поиск по всем заметкам в Apple Notes - Находит заметки, содержащие любое из указанных ключевых слов - Поиск без учёта регистра в содержимом заметок - Возвращает сведения о заметках с найденными ключевыми словами Формат вывода: - Нумерованный список подходящих заметок - Названия заметок, ID и расположение в папках - Найденные ключевые слова для каждой заметки

Параметры

keywordsstringобязательный
Comma-separated keywords to search for in note content

update_note

Обновляет существующую заметку по её первичному ключу (ID) с проверкой через AppleScript. Обязательные параметры: note_id, note_name, new_name и new_body Поддерживаемый HTML: `<h1-h6>`, `<b><i><u>`, `<p><div><br>`, `<ul><ol><li>`, `<table>`, `<a>` Рекомендации: используйте семантический HTML, добавляйте `<br>` для отступов, избегайте CSS-стилей Безопасность: AppleScript проверяет совпадение ID и названия перед обновлением Пример: note_id: "p1234" note_name: "Current Note Title" new_name: "<h1>Updated Report</h1>" new_body: "<p>Status: <b>Complete</b></p><br><ul><li>Done</li></ul>"

Параметры

note_idstringобязательный
Primary key ID of the note to update (e.g., 'p1234')
note_namestringобязательный
Current name of the note to verify and update
new_namestringобязательный
New note title wrapped in <h1> tags (e.g., '<h1>Updated Title</h1>')
new_bodystringобязательный
New note body content with appropriate HTML formatting (e.g., '<p>Updated content</p>') For proper spacing between two sections, use <br>.