Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
Установка
{
"mcpServers": {
"obsidian-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "obsidian-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"OBSIDIAN_API_KEY": "your-local-rest-api-key"
}
}
}
}Вместо npx можно использовать bunx obsidian-mcp-server@latest или образ ghcr.io/cyanheads/obsidian-mcp-server:latest.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к Obsidian через плагин Local REST API и дает агенту инструменты для работы с хранилищем. Он читает заметку целиком, по разделу или в виде карты структуры, листает папки, ищет по тексту, по JSONLogic-выражениям или через Omnisearch. Правки можно делать точечно: дописать в раздел, заменить блок под заголовком, изменить одно поле frontmatter, выполнить поиск с заменой внутри заметки или управлять тегами. Удаление всегда требует подтверждения пользователя, а доступ на чтение и запись можно ограничить папками.
Для кого. Для тех, кто ведет базу знаний в Obsidian и хочет, чтобы агент читал и аккуратно дополнял заметки.
Подходит, если
- Нужно найти и собрать информацию из заметок хранилища
- Нужно дописать ежедневную заметку или раздел, не трогая остальное
- Нужно массово поправить теги или поля frontmatter
Не подходит, если
- Obsidian не запущен или плагин Local REST API нельзя установить
- Хранилище синхронизируется только в облаке без локального приложения
Пример запроса к агенту
Найди в Obsidian заметки с тегом проект и допиши в сегодняшнюю ежедневную заметку список открытых задачОграничения
Нужны запущенный Obsidian и плагин Local REST API версий 4.x или 5.x; версия 6.0 несовместима. Требуются Bun 1.4+ или Node.js 24+. Для периодических заметок на плагине 5.0.2 и новее нужно отдельное расширение. Удаление работает только в клиентах с поддержкой запроса подтверждения. Выполнение команд Obsidian выключено по умолчанию.
Как отключить. Удалите блок obsidian-mcp-server из конфигурации MCP-клиента и при желании отключите плагин Local REST API в Obsidian.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| OBSIDIAN_API_KEY обязательная, секрет | Ключ плагина Obsidian Local REST API |
| OBSIDIAN_BASE_URL | Адрес плагина, по умолчанию http://127.0.0.1:27123 |
| MCP_TRANSPORT_TYPE | Транспорт: stdio или http |
| OBSIDIAN_ENABLE_COMMANDS | Включает инструменты для команд Obsidian |
Проверка безопасности
- Читает и изменяет заметки в локальном хранилище
- Использует ключ доступа к Obsidian
Коротко о README
README перечисляет инструменты и ресурсы сервера и подробно описывает поведение каждого инструмента. Даны конфигурации для запуска через bunx, npx и Docker, режим Streamable HTTP и требования к версиям плагина Local REST API. Таблица настроек описывает адрес плагина, ключ и ограничения доступа. Лицензия Apache 2.0.
Частые вопросы
Где взять ключ?
В Obsidian: Settings, Community Plugins, Local REST API. Там генерируется ключ для OBSIDIAN_API_KEY.
Можно ли ограничить доступ?
Да, чтение и запись ограничиваются папками через переменные окружения, а выполнение команд включается только явно.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании