Local REST API для Obsidian
Local REST API for Obsidian
Плагин Obsidian с защищенным REST API и встроенным MCP-сервером: агент читает, ищет и точечно правит заметки хранилища прямо из Claude Code или Cursor
- 3 085 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Ключ API дает запись и удаление любых файлов хранилища, а также запуск любых команд Obsidian
- Заметки и вложения, которые агент читает через MCP, попадают в контекст модели и уходят ее провайдеру
- Сервер слушает только 127.0.0.1, но к нему могут обратиться и другие локальные программы, знающие ключ
Установка
- Работает в
Ручная установка
claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <your-api-key>"Подставьте ключ из настроек плагина. Obsidian должен быть запущен.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключ API дает запись и удаление любых файлов хранилища, а также запуск любых команд Obsidian
- Заметки и вложения, которые агент читает через MCP, попадают в контекст модели и уходят ее провайдеру
- Сервер слушает только 127.0.0.1, но к нему могут обратиться и другие локальные программы, знающие ключ
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин запускает внутри Obsidian локальный HTTPS-сервер на 127.0.0.1:27124 с самоподписанным сертификатом. Доступ закрыт ключом API, который показан в настройках плагина. Одни и те же возможности доступны как REST-эндпоинтами, так и по MCP по адресу /mcp/ в режиме Streamable HTTP. Агент выводит списки файлов, читает заметки вместе с frontmatter и тегами, создает, дописывает, перемещает, копирует и удаляет файлы (удаление по умолчанию отправляет файл в корзину). Главная особенность — точечные правки. Инструмент vault_patch меняет один заголовок, блок со ссылкой или поле frontmatter, не затрагивая остальной текст заметки. Поиск бывает простым полнотекстовым и структурным на JsonLogic по метаданным. Кроме заметок, плагин умеет читать открытый сейчас файл, перечислять теги с числом упоминаний, открывать файл в окне Obsidian и запускать любые команды из палитры команд. Для вложений есть vault_read_binary: изображения возвращаются блоком, который модель видит, а остальные файлы отдаются подписанной ссылкой. Другие плагины могут добавлять собственные маршруты через интерфейс расширений.
Для кого. Для тех, кто ведет заметки в Obsidian и хочет поручить Claude Code, Cursor или скрипту поиск по хранилищу, дозапись в журнал и правку отдельных разделов.
Подходит, если
- Нужно дописать строку под заголовок дневника, не перечитывая и не перезаписывая всю заметку: подойдет `vault_patch` с операцией append
- Надо найти заметки по свойствам, например по тегу и пути, и тут пригодится структурный поиск `search_query` на JsonLogic
- Агент должен работать с заметкой, открытой в Obsidian прямо сейчас: `active_file_get_path` возвращает ее путь
- Хранилище лежит на этом же компьютере, а Obsidian запущен, и достаточно локального подключения по HTTP без внешних сервисов
- Скриптам и расширениям браузера нужен тот же доступ к хранилищу через REST с заголовком Authorization
Не подходит, если
- Obsidian не запущен: сервер живет внутри приложения, и без открытого окна агенту подключаться не к чему
- Нужен MCP-сервер, который читает папку с Markdown напрямую без плагина и работает при закрытом Obsidian
- Хранилище лежит на телефоне или сервере без доступа к 127.0.0.1 компьютера, где запущены агент и Obsidian
- Заметки нельзя ни читать, ни менять никому, кроме вас, и вы не готовы дать агенту ключ API с правом записи
Пример запроса к агенту
Найди в моем хранилище Obsidian заметки с тегом проект и добавь в конец раздела Задачи в заметке «Планы на неделю» новую строкуMCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
- Плагин ставится в Obsidian и работает, пока приложение запущено. Ключ API показан в Settings, Local REST API.
- Сертификат самоподписанный. Клиенты принимают его после установки доверия, а curl обычно запускают с флагом -k. Центр сертификации можно скачать с https://127.0.0.1:27124/obsidian-local-rest-api.crt.
- Claude Desktop не поддерживает удаленные HTTP-серверы напрямую, нужен мост mcp-remote и Node.js.
- Подписанные ссылки включены по умолчанию и отключаются в расширенных настройках плагина.
- Результат MCP-инструмента размером около мегабайта и больше обрушивает отрисовщик Obsidian, поэтому для вложений действует лимит 512 КиБ.
- Платные аккаунты не требуются.
Как отключить. Уберите сервер из клиента: `claude mcp remove obsidian` или блок obsidian в `.mcp.json`. Чтобы закрыть доступ полностью, выключите плагин в настройках Obsidian на вкладке сторонних плагинов, сервер на порту 27124 остановится.
Частые вопросы
Как подключить Obsidian к Claude Code через MCP?
Включите плагин Local REST API, скопируйте ключ из его настроек и выполните `claude mcp add --transport http obsidian https://127.0.0.1:27124/mcp/ --header "Authorization: Bearer <ключ>"`. Тот же блок можно положить в `.mcp.json` проекта.
Как настроить Obsidian MCP для Claude Desktop?
Claude Desktop не поддерживает удаленные HTTP-серверы напрямую, поэтому в `claude_desktop_config.json` указывают команду npx с пакетом mcp-remote@latest, адресом https://127.0.0.1:27124/mcp/ и заголовком Authorization. После правки перезапустите Claude Desktop. Нужен Node.js.
Как изменить только один раздел заметки?
Используйте `vault_patch` или PATCH-запрос с JSON-инструкцией, где указаны targetType (heading, block или frontmatter), target, operation и content. Операции: append, prepend, replace, delete и перемещение. Остальной текст файла остается нетронутым.
Чем плагин отличается от MCP-серверов вроде mcp-obsidian?
Сервер встроен в сам плагин и работает на том же ключе и порте, что и REST API, внешний процесс и посредник не нужны. Серверы вроде mcp-obsidian запускаются отдельной командой и подключаются к этому плагину по REST.
Что делать, если клиент ругается на сертификат?
Скачайте центр сертификации плагина с https://127.0.0.1:27124/obsidian-local-rest-api.crt и добавьте его в доверенные в системе или браузере. Клиенту HTTP можно также передать путь к этому файлу напрямую.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Локальный MCP-сервер для безопасного чтения, поиска и правки заметок в хранилище Obsidian, доступ ограничен корнем хранилища
Obsidian MCP Plugin
obsidian-mcp-plugin
Плагин Obsidian: сервер MCP работает внутри Obsidian, восемь инструментов для хранилища, поиска и графа. Установка через каталог плагинов или .mcpb
Obsidian MCP
obsidian-mcp
Локальный MCP-сервер для хранилищ Obsidian: читает и правит явно указанные папки с файлами Markdown, Obsidian открывать не нужно
Agent Client для Obsidian
Agent Client
Плагин Obsidian, который запускает Claude Code, Codex и другие агенты по Agent Client Protocol прямо внутри хранилища заметок
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Local REST API для Obsidian (эта запись) | нет | API-ключ | 3 085 | |
| mcp-obsidian | нет | API-ключ | 4 507 | отдельный MCP-сервер, который ходит в хранилище через этот же плагин по REST и запускается своей командой |
| Obsidian MCP Plugin | нет | API-ключ | 467 | тоже плагин Obsidian со встроенным MCP, дает восемь инструментов для хранилища, поиска и графа |
| Obsidian MCP Server | нет | API-ключ | 700 | внешний MCP-сервер для заметок, запускается отдельным процессом |
Коротко о README
Страница открывается обзором возможностей и быстрым стартом: примеры curl для REST и настройка MCP-клиентов Claude Code, Claude Desktop и Cursor. Следом идут обзор эндпоинтов, заметки о точечных правках, адресация разделов, виды поиска, потоки событий и состояние сервера. Большой раздел посвящен MCP: версии протокола, список инструментов, работа с бинарными файлами, подписанные ссылки и ресурсы. Завершают страницу интерфейс расширений для других плагинов, список известных расширений и сведения для разработчиков.