Obsidian MCP Tools — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Локальный плагин Obsidian + MCP-мост
Семантический поиск через интеграцию со Smart Connections
Запуск Templater-промптов из Claude
Полный CRUD файлов: чтение, запись, добавление, ссылки, frontmatter
Поддержка ежедневных заметок и журнала
Данные хранилища никогда не покидают вашу машину

Живое демо

Как выглядит на практике

obsidian-mcp-tools.replay ▶ готово

0/0

Установка

Выберите клиент

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

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "obsidian-mcp-tools",
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-tools"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "obsidian-mcp-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "obsidian-mcp-tools"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add obsidian-mcp-tools -- npx -y obsidian-mcp-tools

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Obsidian MCP Tools

Как реально запрашивать второй мозг вместо grep-поиска

👤 Пользователи Obsidian PKM с 1000+ заметок ⏱ ~20 min intermediate

Когда использовать: Вы знаете, что писали об этом несколько месяцев назад, но поиск по ключевому слову постоянно промахивается.

Предварительные требования

Obsidian + данный плагин + плагин Smart Connections — Установите оба из раздела Community Plugins; Smart Connections проиндексирует при первом запуске

Поток

Проверить индекс

Verify Smart Connections has finished embedding my vault. Report total notes indexed.✓ Скопировано

→ Количество проиндексированных заметок; используемая модель эмбеддингов
Семантическое извлечение

Find notes related to 'why I left my last job' even if those exact words aren't in any note.✓ Скопировано

→ 5 заметок, отранжированных по семантической близости, со сниппетами
Составить

Synthesize those into a short reflection note. Save under /Reflections/ with a wikilink to each source.✓ Скопировано

→ Новая заметка создана; backlinks работают

Итог: Второй мозг, который отвечает на концептуальные вопросы, а не только на ключевые слова.

Подводные камни

Семантическое извлечение выдаёт конфиденциальные личные заметки — Используйте настройку excludedFolders в Smart Connections, чтобы исключить приватные папки

Сочетать с: humanizer-skill

Запуск Templater-шаблона из Claude с автозаполнением промптов

👤 Продвинутые пользователи Obsidian с шаблонами ⏱ ~10 min intermediate

Когда использовать: У вас есть Templater-шаблон «начало проекта» с 5 вопросами; лучше, чтобы Claude его оркестрировал.

Предварительные требования

Templater установлен с настроенными шаблонами — Стандартный плагин сообщества

Поток

Список шаблонов

What Templater templates are available?✓ Скопировано

→ Список шаблонов с описаниями промптов
Запустить с автозаполнением

Run 'project_kickoff' for a project called 'Q3 onboarding overhaul'. Auto-answer the prompts based on context.✓ Скопировано

→ Создана новая заметка по шаблону; промпты заполнены

Итог: Шаблоны запускаются из чата, а не через диалоговое окно.

Подводные камни

Некоторые команды Templater асинхронны и требуют времени — MCP-инструмент ждёт завершения — но не цепочьте слишком много в одном вызове

Автоматическое создание ежедневной заметки из вчерашнего календаря и задач

👤 Пользователи Obsidian, ориентированные на продуктивность ⏱ ~15 min intermediate

Когда использовать: Каждое утро вы редактируете один и тот же шаблон «Daily» — автоматизируйте это.

Поток

Получить данные за сегодня

Read yesterday's daily note. Carry forward incomplete tasks. Pull today's calendar via google-calendar MCP.✓ Скопировано

→ Перенесённые задачи + события на сегодня определены
Записать ежедневную заметку

Create today's daily note in /Daily/$(date +%F).md with the standard sections.✓ Скопировано

→ Заметка создана и открыта

Итог: Ежедневная заметка готова за 5 секунд.

Подводные камни

Перенос задач дублирует их, если одна задача встречается в 2 днях — Дедублируйте по тексту строки перед записью

Сочетать с: google-calendar

Комбинации

Сочетайте с другими MCP — эффект x10

obsidian-mcp-tools + google-calendar

Создавать ежедневные заметки, включающие события дня

obsidian-mcp-tools + github

Зеркалировать доску проекта в заметку хранилища

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search_semantic	query, k?	Концептуальное извлечение	1 запрос Smart Connections
read_note	path	Получить одну заметку	бесплатно
write_note	path, content, mode: 'create'\|'append'\|'overwrite'	Создать или обновить заметку	бесплатно
list_templates	(нет)	Узнать, что можно выполнить	бесплатно
run_templater	template_name, prompt_answers: {}	Выполнить шаблонизированный рабочий процесс	бесплатно

Стоимость и лимиты

Во что обходится

Квота API: Локально — зависит от сервиса эмбеддингов Smart Connections (если облачный)
Токенов на вызов: 100–1500 на заметку
Деньги: Бесплатно (плагин); Smart Connections имеет бесплатный локальный и платный облачный варианты
Совет: Используйте локальный вариант эмбеддингов в Smart Connections, чтобы избежать затрат на запрос

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Только локальный плагин; без удалённого хранилища

Исходящий трафик: Локально — за исключением случаев, когда Smart Connections настроен на облачные эмбеддинги

Не давайте Claude доступ на запись в хранилище, если не доверяете своему prompt'у; используйте папки исключений для конфиденциальных областей

Устранение неполадок

Частые ошибки и исправления

MCP-инструменты не отображаются

Убедитесь, что плагин Obsidian включён и MCP-мост запущен

Проверить: Проверьте статусную панель плагина; перезапустите Obsidian

search_semantic возвращает пусто

Задание эмбеддингов Smart Connections может ещё не завершиться — проверьте прогресс

Проверить: Откройте боковую панель Smart Connections

write_note завершается с ошибкой 'path outside vault'

Пути задаются относительно корня хранилища; не используйте абсолютные пути

Альтернативы

Obsidian MCP Tools в сравнении

Альтернатива	Когда использовать	Компромисс
ergut/mcp-logseq	Вы используете Logseq вместо Obsidian	Другая экосистема; та же идея
AgriciDaniel/claude-obsidian (skill)	Вы хотите skill-ориентированный рабочий процесс поверх файлового ввода-вывода	Skill более высокоуровневый; данный MCP — строительные блоки

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills