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

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

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

Восемь инструментов, охватывающих заметки, теги, вставку и поиск.
Режимы обновления «Добавить/добавить/перезаписать» — агентам не нужно заново создавать целые файлы.
Атомарные операции на ключевом уровне
Глобальный нечеткий поиск по всему хранилищу
Уровень кэширования для более быстрого повторного чтения

Живое демо

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

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

0/0

Установка

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

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

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "obsidian-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "obsidian-mcp-server"
      ],
      "env": {
        "OBSIDIAN_API_KEY": "<from Local REST API plugin>",
        "OBSIDIAN_BASE_URL": "http://127.0.0.1:27123"
      }
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add obsidian-mcp-server -- npx -y obsidian-mcp-server

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

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

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

Записывайте идеи в ежедневную заметку из любого клиента MCP.

👤 Пользователи Obsidian, живущие в чате ⏱ ~5 min beginner

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

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

Obsidian с включенным плагином Local REST API — Плагины сообщества → установите «Локальный REST API» → скопируйте ключ API.
Клиент MCP, настроенный с помощью OBSIDIAN_API_KEY + OBSIDIAN_BASE_URL — См. блок конфигурации; базовый URL-адрес обычно http://127.0.0.1:27123.

Поток

Проверьте наличие ежедневной заметки

Список примечаний в разделе Daily/2026-04-17.md.✓ Скопировано

→ Путь к файлу подтвержден или «не найден»
Добавить снимок

Добавьте «- Идея: попробуйте X для устранения ошибки кэширования» в Daily/2026-04-17.md.✓ Скопировано

→ Добавление подтверждено без перезаписи предыдущих записей

Итог: Текущий журнал, который агенты могут добавлять, но не засорять.

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

Использование режима перезаписи, когда вы имели в виду добавление — Всегда по умолчанию добавляется или добавляется в начало ежедневных заметок; сохранить перезапись для новых черновиков

Сочетать с: filesystem

Превратите недельные заметки в обзорный документ

👤 Работники умственного труда проводят еженедельные обзоры ⏱ ~20 min intermediate

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

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

Заметки с тегами или датами — Используйте #weekly или папку Daily/.

Поток

Поиск заметок недели

Глобальный поиск: заметки, измененные на этой неделе в разделе Daily/.✓ Скопировано

→ Список из 5–7 путей к файлам
Прочитайте каждый

Прочитайте каждую ежедневную заметку и подведите итог по темам.✓ Скопировано

→ Тематические пули, а не сырая конкатенация
Написать отзыв

Напишите резюме в Reviews/2026-W16.md; добавить статус заголовка: обзор, теги: [еженедельно].✓ Скопировано

→ Новый файл с правильным вступлением

Итог: Еженедельный обзор, созданный из исходного материала без ручного копирования.

Сочетать с: github

Объедините беспорядочные теги в хранилище

👤 Хранилища, которые выросли естественным образом и теперь имеют варианты #Work / #work / #WORK. ⏱ ~30 min intermediate

Когда использовать: Список тегов слишком длинный из-за дубликатов и почти дубликатов.

Поток

Список текущих тегов

Используйте obsidian_manage_tags для отображения всех тегов, отсортированных по использованию.✓ Скопировано

→ Подсчет тегов выявляет дубликаты
Предложить картографию

Предложите каноническое множество и отображение старое → новое.✓ Скопировано

→ Небольшой обзорный столик.
Применять пакетно

После моего подтверждения переименуйте теги в хранилище, используя сопоставление.✓ Скопировано

→ Операции с тегами суммированы для каждой заметки

Итог: Чистая таксономия тегов, по которой вы действительно можете ориентироваться.

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

Переписывание сотен заметок за один раз без резервной копии — Сначала зафиксируйте хранилище в git; просмотрите разницу

Сочетать с: git

Перемещайте веб-вырезки в почтовый ящик для исследований и автоматически отмечайте их тегами.

👤 Исследователи, аналитики, все, кто любит пользоваться машинкой для стрижки ⏱ ~15 min beginner

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

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

Назначенный почтовый ящик/папка — Создайте его в хранилище

Поток

Список входящих

Перечислите непомеченные заметки в папке «Входящие/».✓ Скопировано

→ Пути ожидающих элементов
Классифицируйте и маркируйте

Для каждого предложите 1–3 тега в зависимости от контента, а затем примените его с помощью obsidian_manage_tags.✓ Скопировано

→ Теги добавляются атомарно через заголовок

Итог: Папка «Входящие» остается маленькой; новые клипы организуются автоматически.

Сочетать с: fetch

Комбинации

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

obsidian-mcp-server + fetch

Вырежьте URL-адрес с помощью fetch, а затем запишите его в папку «Входящие»/

Загрузите https://... и сохраните очищенное резюме в Inbox/YYYY-MM-DD-title.md с правильным заголовком.✓ Скопировано

obsidian-mcp-server + github

Скопируйте объединенные сводки PR в Projects/<repo>.md.

Найдите объединенные запросы на участие на этой неделе и добавьте сводку в раздел ## Неделя 16 в Projects/acme-api.md.✓ Скопировано

obsidian-mcp-server + git

Версируйте свое хранилище и фиксируйте пакетные изменения

После очистки тегов запустите git diff в хранилище и подведите итоги перед фиксацией.✓ Скопировано

Инструменты

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

Инструмент	Входные данные	Когда вызывать
obsidian_read_note	path: str	Прочтите конкретную заметку, прежде чем редактировать или резюмировать ее.
obsidian_update_note	path: str, content: str, mode: 'append'\|'prepend'\|'overwrite'	Добавить или заменить содержимое заметки — по умолчанию добавляется, если не перезаписывать.
obsidian_search_replace	path: str, find: str, replace: str	Целенаправленное редактирование в заметках без регенерации всего файла.
obsidian_global_search	query: str, filters?	Находите заметки по всему хранилищу
obsidian_list_notes	folder?: str	Перечислите заметки в папке перед пакетными операциями
obsidian_manage_frontmatter	path: str, op: 'get'\|'set'\|'delete', key?: str, value?: any	Атомарные изменения в заставке на ключевом уровне
obsidian_manage_tags	path?: str, op: 'list'\|'add'\|'remove'	Гигиена тегов и операции таксономии
obsidian_delete_note	path: str	Удаление заметки — навсегда, без возможности отмены

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

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

Квота API: Никакого внешнего API — локальный REST API работает на вашем Mac/ПК.
Токенов на вызов: Размер заметки; типично 200–3000
Деньги: Бесплатно
Совет: Предпочитайте global_search + чтение по требованию вместо массового перечисления целых папок в контексте.

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

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

Хранение учётных данных: OBSIDIAN_API_KEY только в env var — никогда не фиксируется. Относитесь к нему как к токену локального администратора вашего хранилища.

Исходящий трафик: Весь трафик локальный → Obsidian Local REST API. С этого сервера нет облачных вызовов.

Плагин Local REST API предоставляет доступ к вашему хранилищу через локальный порт HTTP; привязывайтесь только к 127.0.0.1 и отключайте HTTPS только для локального хоста.
Злоумышленник, получивший доступ к вашему OBSIDIAN_API_KEY, получает полный доступ к чтению и записи в хранилище — поменяйте его, если вы подозреваете утечку.

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

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

ЭКОННРЕФУСЕД 127.0.0.1:27123

Obsidian не запущен или плагин Local REST API отключен. Откройте Obsidian и включите плагин.

Проверить: curl -H 'Authorization: Bearer $OBSIDIAN_API_KEY' http://127.0.0.1:27123/vault/

401 Несанкционированный

OBSIDIAN_API_KEY не соответствует текущему ключу плагина. Скопируйте значение из настроек плагина еще раз.

Проверить: Plugin Settings → Local REST API → copy the API key

404 в известном файле

Путь зависит от хранилища и учитывает регистр — подтвердите с помощью obsidian_list_notes.

Проверить: obsidian_list_notes folder='Daily'

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

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

Альтернатива	Когда использовать	Компромисс
obsidian-plugin-skill	Вы хотите, чтобы Клод помогал создавать плагины Obsidian, а не редактировал содержимое хранилища.	Разная сфера применения
filesystem MCP	Вы хорошо справляетесь с необработанными операциями с файлами и не нуждаетесь в API-интерфейсах/тегах, поддерживающих Obsidian.	Вы теряете атомарные операции с тегами/фронтом.

Ещё

Ресурсы

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

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

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