Каталог MCP
henilcalagiya/mcp-apple-notes

henilcalagiya/mcp-apple-notes

MCP-сервер для автоматизации Apple Notes на macOS. Создавайте, редактируйте и удаляйте заметки и папки, ищите по ключевым словам. Работает с MCP-клиентами (Continue.dev, Claude Desktop). Основан на...

README

14 инструментов

Версии

Установить сервер

Apple Notes MCP Server

Powerful tools for automating Apple Notes using Model Context Protocol (MCP)

mcp-name: io.github.henilcalagiya/mcp-apple-notes

Overview

Apple Notes MCP Server provides seamless integration of Apple Notes with any MCP-compatible client. It enables full note automation — including creating, reading, updating, and deleting notes — through a simple and secure AppleScript API layer.

Features

Full CRUD support for Apple Notes (Create, Read, Update, Delete)
Works with Continue.dev, Claude Desktop, Perplexity, and other MCP clients
Native AppleScript integration for reliable macOS automation
Comprehensive tools for Apple Notes automation
Automatic installation via uvx or manual setup
FastMCP implementation with modern decorator-based API

Requirements

macOS - Required for AppleScript support
Python 3.10+ - Required for MCP SDK compatibility
Apple Notes application - Must be installed and accessible
MCP-compatible client (e.g., Continue.dev, Claude Desktop)

Quick Start

Step 1: Install uv (if not already installed)

Инструменты были проиндексированы: 11.09.2026

create_folder

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

Параметры

folder_namestringобязательный
Имя создаваемой папки (1–128 символов, без < > : " | ? *)
folder_pathstring
Необязательный вложенный путь (например, 'Work/Projects'). Если пусто, создается в корневом уровне. Максимум 5 уровней глубины.

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>"

Параметры

bodystringобязательный
Оформляет содержимое заметки с подходящим HTML-форматированием (например, '<p>Content here</p>'). Для правильного интервала между двумя разделами используйте <br>.
folder_pathstring
Путь к целевой папке (например, 'Work' или 'Work/Projects/2024'). По умолчанию: 'Notes'.
namestringобязательный
Заголовок заметки, заключённый в теги <h1> (например, '<h1>My Note Title</h1>')

delete_folder

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

Параметры

folder_idstringобязательный
ID первичного ключа папки, которую нужно удалить (например, 'p2330')
folder_namestringобязательный
Имя папки для проверки и удаления.

delete_note

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

Параметры

note_idstringобязательный
Идентификатор первичного ключа заметки, которую нужно удалить (например, 'p1308')
note_namestringобязательный
Название заметки для проверки и удаления.

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обязательный
Первичный ключ ID папки для перемещения (например, 'p2330')
folder_namestringобязательный
Название папки для проверки и перемещения
target_pathstring
Целевой путь для перемещения папки (например, 'Archive'). Если оставить пустым, перемещается в корневой уровень.

move_note

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

Параметры

note_idstringобязательный
Идентификатор первичного ключа заметки для перемещения (например, 'p1308')
note_namestringобязательный
Название заметки для проверки и перемещения
target_folder_pathstringобязательный
Путь целевой папки, куда переместить заметку (например, 'Archive' или 'Work/Completed')

read_folder

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

Параметры

folder_idstringобязательный
Идентификатор первичного ключа папки для чтения (например, 'p2330')
folder_namestringобязательный
Имя папки для проверки и чтения

read_note

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

Параметры

note_idstringобязательный
Первичный ключ ID заметки для чтения (например, 'p1308')
note_namestringобязательный
Имя заметки для проверки и чтения.

rename_folder

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

Параметры

current_namestringобязательный
Текущее имя папки для проверки и переименования
folder_idstringобязательный
Идентификатор первичного ключа папки для переименования (например, 'p2330')
new_namestringобязательный
Новое имя для папки (1–128 символов, без < > : " | ? *)

search_notes

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

Параметры

keywordsstringобязательный
Ключевые слова, разделенные запятыми, для поиска в содержимом заметок

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>"

Параметры

new_bodystringобязательный
Новое содержимое заметки с соответствующим HTML-форматированием (например, '<p>Обновленное содержимое</p>'). Для правильного разделения двух разделов используйте <br>.
new_namestringобязательный
Новый заголовок заметки, обернутый в теги <h1> (например, '<h1>Обновленный заголовок</h1>')
note_idstringобязательный
Идентификатор первичного ключа записи для обновления (например, 'p1234')
note_namestringобязательный
Текущее название заметки для проверки и обновления.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "uvx",
  "args": [
    "mcp-apple-notes@latest"
  ]
}

Нужен uvx

Сервер запускается через uvx
Без него ничего работать не будет.

Как установить uvx

FAQ

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

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

Что он умеет?

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

Информация о сервере

Номер в рейтинге: #193
Звезд на Github: 52
Форков на Github: 8
Загрузок: 1 176
Язык реализации: Python
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 11.09 в 13:38
Идентификатор: _irnlqcMRh7hiBhn
Категории: Автоматизация ОС, Автоматизация приложений, Заметки, Знания и память, Инструменты для разработчиков, Рабочее место и продуктивность