MCP-сервер Apple Notes

Name: Apple Notes MCP Server
Author: ailenshen

Чтение и запись заметок Apple Notes с поддержкой собственного форматирования Apple Notes.

apple-notes-mcp MCP server

Большинство MCP-серверов для Apple Notes могут записывать только обычный текст. Этот сервер создает заметки с собственным форматированием — заголовки, полужирный шрифт, списки — всё это отображается как настоящие стили Apple Notes, а не как обычный текст. Это достигается за счет использования встроенной функции импорта Markdown в приложении Notes.app.

Требования: macOS 26 (Tahoe) или новее, Node.js 24+

Настройка

1. Добавление в ваш MCP-клиент

Claude Desktop — отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@ailenshen/apple-notes-mcp@latest"]
    }
  }
}

Claude Code — выполните в терминале:

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

2. Предоставление разрешений

Для поддержки собственного форматирования сервер использует встроенный импорт Markdown в Notes.app — он открывает файлы .md с помощью Notes.app и автоматически подтверждает диалоговое окно импорта. Для этого требуются два разрешения macOS для node:

Разрешение	Где включить	Зачем
Полный доступ к диску	Системные настройки > Конфиденциальность и безопасность > Полный доступ к диску > включите `node`	Чтение базы данных заметок для перечисления и поиска
Универсальный доступ	Системные настройки > Конфиденциальность и безопасность > Универсальный доступ > включите `node`	Автоматическое подтверждение диалогового окна импорта при создании заметок

При первом использовании macOS предложит вам подтвердить действие — просто нажмите «Разрешить». Если вы пропустили запрос, перейдите в указанные выше настройки и включите node вручную. После предоставления разрешений перезапустите ваш MCP-клиент.

Если разрешение отсутствует, сервер сообщит вам, какое именно и как его исправить.

3. Начало работы

Просто общайтесь со своим ИИ естественным образом:

"List all my notes in the Projects folder"
"Search my notes for 'meeting agenda'"
"Read my Shopping List note"
"Create a note in Work with today's action items"
"Update my Shopping List with these new items"
"Delete the note called 'Old Draft'"

Что он умеет?

Инструмент	Описание
`list_notes`	Просмотр заметок, с возможностью фильтрации по папкам
`search_notes`	Поиск заметок по ключевым словам
`get_note`	Чтение полного содержимого в формате Markdown
`create_note`	Запись Markdown → заметка с собственным форматированием
`update_note`	Замена содержимого с сохранением папки
`delete_note`	Перемещение в «Недавно удаленные»

Поддержка Markdown в Notes

Элемент	Работает?
Заголовки, полужирный, курсив, списки, `inline code`	Да
Цитаты	Содержимое сохраняется, стиль отступа отсутствует
Ссылки	Текст сохраняется, URL теряется
Таблицы, сноски	Нет

Удаленный доступ (режим HTTP)

Хотите получить доступ к своим заметкам Apple Notes с телефона или другого компьютера?

npx @ailenshen/apple-notes-mcp@latest --http

Это выведет URL-адрес конечной точки со встроенным секретным ключом:

Endpoint: http://localhost:3100/mcp/a3f8b2c9e1d4...

Укажите этот URL в своем удаленном MCP-клиенте. Чтобы получить доступ через интернет, разместите его за HTTPS с помощью туннеля (ngrok, Cloudflare Tunnel и т. д.).

Флаг	По умолчанию	Описание
`--port <number>`	3100	Номер порта
`--secret <string>`	случайный	Пользовательский секретный ключ URL

Чтобы он продолжал работать после перезагрузки, см. пример LaunchAgent в вики.

Как это работает

Действие	Метод	Скорость
Список / Поиск	SQLite (только чтение)	< 100 мс
Чтение	AppleScript → Markdown	~1 с
Создание	Собственный импорт Markdown	~0.5 с
Обновление	Удаление + Создание	~1.5 с
Удаление	AppleScript	~1 с

Чтение напрямую запрашивает базу данных заметок через SQLite — это быстро и безопасно. Содержимое преобразуется из HTML Apple в Markdown с помощью turndown.
Создание использует собственный импорт Markdown в macOS (open -a Notes), поэтому форматирование сохраняется в исходном виде. Приложение Notes.app ненадолго появляется (~0.5 с) во время создания.
Обновление удаляет старую заметку и создает новую, автоматически сохраняя исходную папку.
Удаление перемещает заметки в «Недавно удаленные», так же, как если бы вы делали это вручную.

Известные ограничения

Частичное редактирование заметок (например, «исправь только этот абзац») не поддерживается. update_note всегда заменяет всё содержимое целиком. Это фундаментальное ограничение того, как Notes предоставляет содержимое — его интерфейс AppleScript возвращает HTML, а не исходный Markdown, поэтому чистый цикл «чтение→редактирование→запись» на данный момент невозможен.
Заметки ненадолго появляются во время создания. Процесс импорта Markdown требует автоматического подтверждения диалогового окна в Notes.app, что может на мгновение вывести его на передний план.

Эти ограничения будут сняты, если Apple добавит импорт/экспорт Markdown в AppleScript или откроет официальный API Notes — оба варианта отслеживаются для будущих выпусков macOS.

Видение

Apple Notes — это самое естественное место для хранения личных знаний на устройствах Apple: они синхронизируются везде, работают быстро и конфиденциальны. Но это «закрытый сад» без API.

Этот проект делает Apple Notes первоклассным источником данных для ИИ. Долгосрочная цель: где бы вы ни общались с ИИ — на Mac, на телефоне, в интернете — ваши заметки Apple Notes всегда доступны, читаемы и доступны для записи.

Лицензия

MIT

Apple Notes MCP Server