Добавить сервер
henilcalagiya/mcp-apple-notes

    henilcalagiya/mcp-apple-notes

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

    Apple Notes MCP Server

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

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

    PyPI version License: MIT Python 3.10+

    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)

    Часто задаваемые вопросы

    Инструменты были проиндексированы:
    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обязательный

      Текущее название заметки для проверки и обновления.

    0.1.2основная
    0.1.1
    0.1.0

    Выберите клиент, чтобы установить henilcalagiya/mcp-apple-notes:

    Любой клиент

    Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

    Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

    {
  "mcpServers": {
    "henilcalagiya-mcp-apple-notes-fegeryl0iu": {
      "command": "uvx",
      "args": [
        "mcp-apple-notes@latest"
      ]
    }
  }
}
    VS Code

    Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

    {
  "servers": {
    "henilcalagiya-mcp-apple-notes-fegeryl0iu": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-apple-notes@latest"
      ]
    }
  }
}

    Либо добавьте сервер через терминал:

    code --add-mcp "{\"name\":\"henilcalagiya-mcp-apple-notes-fegeryl0iu\",\"type\":\"stdio\",\"command\":\"uvx\",\"args\":[\"mcp-apple-notes@latest\"]}"
    ClaudeClaude Desktop

    Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    Впишите сервер и полностью перезапустите Claude Desktop:

    {
  "mcpServers": {
    "henilcalagiya-mcp-apple-notes-fegeryl0iu": {
      "command": "uvx",
      "args": [
        "mcp-apple-notes@latest"
      ]
    }
  }
}
    Claude CodeClaude Code

    Добавьте сервер одной командой в терминале:

    claude mcp add henilcalagiya-mcp-apple-notes-fegeryl0iu -- uvx mcp-apple-notes@latest

    Либо через JSON-конфиг:

    claude mcp add-json henilcalagiya-mcp-apple-notes-fegeryl0iu "{\"command\":\"uvx\",\"args\":[\"mcp-apple-notes@latest\"]}"
    CodexCodex

    Добавьте сервер командой в терминале:

    codex mcp add henilcalagiya-mcp-apple-notes-fegeryl0iu -- uvx mcp-apple-notes@latest

    Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

    [mcp_servers.henilcalagiya-mcp-apple-notes-fegeryl0iu]
command = "uvx"
args = ["mcp-apple-notes@latest"]
    PerplexityPerplexity

    MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

    1. Откройте Настройки аккаунта → Connectors.
    2. Установите вспомогательное приложение PerplexityXPC (один раз).
    3. Нажмите Add Connector → вкладка Simple.
    4. В поле Server Name укажите henilcalagiya/mcp-apple-notes, а в поле команды запуска — строку ниже:
    uvx mcp-apple-notes@latest

    Нажмите Save и дождитесь статуса Running.

    WindsurfWindsurf

    Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

    В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

    {
  "mcpServers": {
    "henilcalagiya-mcp-apple-notes-fegeryl0iu": {
      "command": "uvx",
      "args": [
        "mcp-apple-notes@latest"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
    Continue

    Создайте файл в .continue/mcpServers/ (например henilcalagiya-mcp-apple-notes-fegeryl0iu.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

    mcpServers:
  - name: henilcalagiya-mcp-apple-notes-fegeryl0iu
    command: uvx
    args:
      - "mcp-apple-notes@latest"
    Zed

    Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

    Похожие MCP-сервера

    ailenshen/apple-notes-mcp

    ailenshen/apple-notes-mcp

    от ailenshen

    MCP сервер для управления Apple Notes: чтение, запись и поиск с нативным форматированием. Полезен пользователям Mac, использующим AI-ассистентов. Требует macOS 26 и Node.js 24.

    Swift⭐ 12
    Dan8Oren/mcp-apple-notes

    Dan8Oren/mcp-apple-notes

    от dan8oren

    MCP сервер для семантического поиска и RAG по Apple Notes. Работает полностью локально - не требует API-ключей, данные не покидают устройство. Интегрируется с Claude Desktop, Cursor, Windsurf. Ищит...

    JavaScript⭐ 14
    akseyh/bear-mcp-server

    akseyh/bear-mcp-server

    от akseyh

    MCP-сервер для работы с заметками Bear Notes. Через SQLite читает все заметки, ищет по тексту и выводит теги. Интегрируется с MCP-клиентами (Claude Desktop) для автоматизации вашей базы знаний на m...

    JavaScript⭐ 45
    Notion MCP

    Notion MCP

    официальный

    от makenotion

    Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.

    TypeScript⭐ 4673
    smith-and-web/obsidian-mcp-server

    smith-and-web/obsidian-mcp-server

    от smith-and-web

    MCP-сервер для интеграции AI-ассистентов с Obsidian: создавайте, читайте, редактируйте заметки, управляйте тегами и ищите по хранилищу через естественный язык. Полезен для автоматизации работы с за...

    TypeScript⭐ 19
    kj455/mcp-kibela

    kj455/mcp-kibela

    от kj455

    MCP-сервер для интеграции AI-ассистентов с корпоративной базой знаний Kibela. Умеет искать заметки по ключевым словам, получать содержимое по ID или пути, создавать и редактировать записи — идеальн...

    TypeScript⭐ 13
    © Каталог MCP, 2026. Все права защищены.
    Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
    Все названия и торговые марки принадлежат их владельцам.
    Контакты для связи: hi@mcp-katalog.ru

    Лука Никитин