ailenshen/apple-notes-mcp

ailenshen/apple-notes-mcp

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

Apple Notes MCP Server

English | 简体中文

Let Claude read and edit your Apple Notes — with native formatting, tables, attachments, and iCloud sync.

apple-notes-mcp MCP server

Claude edits your notes the way you would: change one line or tick a checkbox, and the rest of the note stays exactly as it was — colors, fonts and all. Titles, headings, lists, checklists, tables and highlights are real Apple Notes styles. Claude can also look at the images, scans and PDFs in your notes, and keep your folders tidy.

Apple Notes MCP

Requires: macOS 26 (Tahoe) or later, Node.js 24+, and Claude Code, Claude Desktop (including Cowork and Code sessions) or claude.ai. Other MCP clients work too: it speaks MCP 2026-07-28 and the older initialize handshake (2024-11-05 to 2025-11-25)

Setup

1. Add to Claude

Claude Code — run in Terminal:

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

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude:

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

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

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

Создаёт новую заметку в Apple Notes из содержимого Markdown. Первая строка становится заголовком. Опционально указывает целевую папку (по умолчанию 'Notes').

Параметры
  • folderstring

    Имя целевой папки (например, 'Projects'). По умолчанию: 'Notes'.

  • markdownstringобязательный

    Содержимое заметки в формате Markdown. Первая строка (с # или без) становится заголовком.

delete_note

Удаляет заметку из Apple Notes по заголовку. Дополнительно указывает папку для устранения неоднозначности. Переносит заметку в Recently Deleted.

Параметры
  • folderstring

    Имя папки для ограничения области поиска.

  • titlestringобязательный

    Название заметки для удаления

get_note

Получает полное содержимое заметки по её названию, возвращаемое в формате Markdown. При необходимости указывает папку для устранения неоднозначности.

Параметры
  • folderstring

    Имя папки для ограничения области поиска.

  • titlestringобязательный

    Заголовок заметки (точное совпадение)

list_notes

Выводит заметки из Apple Notes. Возвращает заголовок, папку, даты, статус закрепления, фрагмент. Опционально фильтрует по имени папки и ограничивает результаты.

Параметры
  • folderstring

    Фильтр по имени папки

  • limitnumber

    Максимальное количество возвращаемых заметок

search_notes

Ищет в Apple Notes по ключевому слову. Ищет в заголовке и сниппете. Возвращает подходящие заметки с метаданными.

Параметры
  • limitnumber

    Максимальное количество результатов

  • querystringобязательный

    Ключевое слово для поиска

update_note

Обновляет существующую заметку в Apple Notes. Удаляет старую заметку и создаёт новую с указанным содержимым в Markdown, сохраняя исходную папку.

Параметры
  • folderstring

    Имя папки для ограничения области поиска существующей заметки.

  • markdownstringобязательный

    Новое содержимое Markdown для заметки. Первая строка (с # или без) становится заголовком.

  • titlestringобязательный

    Заголовок существующей заметки для обновления

2.0.2основная
2.0.1
2.0.0
2.0.0-beta.9
2.0.0-beta.8
2.0.0-beta.7
2.0.0-beta.6
2.0.0-beta.5
2.0.0-beta.4
2.0.0-beta.3
2.0.0-beta.2
2.0.0-beta.1
1.4.1
1.3.3
1.3.2
1.3.1
1.3.0
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.1
1.0.0

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

Любой клиент

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

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

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

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

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

{
  "servers": {
    "ailenshen-apple-notes-mcp-y81sdt0lxj": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ailenshen/apple-notes-mcp@latest"
      ]
    }
  }
}

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

code --add-mcp "{\"name\":\"ailenshen-apple-notes-mcp-y81sdt0lxj\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@ailenshen/apple-notes-mcp@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": {
    "ailenshen-apple-notes-mcp-y81sdt0lxj": {
      "command": "npx",
      "args": [
        "-y",
        "@ailenshen/apple-notes-mcp@latest"
      ]
    }
  }
}
Claude CodeClaude Code

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

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

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

claude mcp add-json ailenshen-apple-notes-mcp-y81sdt0lxj "{\"command\":\"npx\",\"args\":[\"-y\",\"@ailenshen/apple-notes-mcp@latest\"]}"
CodexCodex

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

codex mcp add ailenshen-apple-notes-mcp-y81sdt0lxj -- npx -y @ailenshen/apple-notes-mcp@latest

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

[mcp_servers.ailenshen-apple-notes-mcp-y81sdt0lxj]
command = "npx"
args = ["-y", "@ailenshen/apple-notes-mcp@latest"]
PerplexityPerplexity

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

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

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

WindsurfWindsurf

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

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

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

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

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

mcpServers:
  - name: ailenshen-apple-notes-mcp-y81sdt0lxj
    command: npx
    args:
      - "-y"
      - "@ailenshen/apple-notes-mcp@latest"
Zed

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

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

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

henilcalagiya/mcp-apple-notes

henilcalagiya/mcp-apple-notes

от henilcalagiya

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

Python⭐ 52
Dan8Oren/mcp-apple-notes

Dan8Oren/mcp-apple-notes

от dan8oren

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

JavaScript⭐ 14
vasylenko/claude-desktop-extension-bear-notes

vasylenko/claude-desktop-extension-bear-notes

от vasylenko

MCP инструмент для Bear Notes с релевантным поиском по заголовкам, тексту и тегам. Работает полностью локально — читает данные из SQLite без запуска Bear, запись через URL-схему. Подходит для точного поиска и управления заметками в офлайн-режиме.

TypeScript⭐ 205
suekou/mcp-notion-server

suekou/mcp-notion-server

от suekou

MCP-сервер для интеграции Notion с AI-агентами: поиск, чтение, редактирование страниц и баз данных, создание элементов, выполнение запросов. Компактные ответы для AI-рабочих процессов. Для разработ...

TypeScript⭐ 921
Notion MCP

Notion MCP

официальный

от makenotion

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

TypeScript⭐ 4673
louis030195/easy-obsidian-mcp

louis030195/easy-obsidian-mcp

от louis030195

MCP-сервер для подключения AI-ассистентов (Claude, ChatGPT) к Obsidian: поиск, чтение и анализ связей между заметками. Полезен для пользователей Obsidian, которые хотят задействовать ИИ для работы ...

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

Лука Никитин