Каталог MCP
louis030195/easy-obsidian-mcp

louis030195/easy-obsidian-mcp

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

README

6 инструментов

Версии

Установить сервер

Obsidian MCP Server

Connect Claude, ChatGPT, and other AI assistants to your Obsidian vault.

💖 Support This Project

If you find this MCP server useful, please consider supporting its development!

👉 Click here to support this project

Your support helps maintain and improve this tool. Thank you! 🙏

Quick Start

1. Install in your AI app

Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "obsidian": {
      "command": "npx",
      "args": ["-y", "@louis030195/mcp-obsidian"],
      "env": {
        "OBSIDIAN_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code:

claude mcp add obsidian "npx -y @louis030195/mcp-obsidian" -s user -e OBSIDIAN_API_KEY="your-api-key-here"

2. Enable Obsidian API (Optional - for full features)

Open Obsidian → Settings → Community plugins
Turn off Restricted mode → Search "Local REST API" → Install & Enable

Copy the API key and add to your config:

"env": {
  "OBSIDIAN_API_KEY": "your-api-key-here"
}

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

obsidian_dataview_search

Выполняет запрос на языке Dataview Query Language (DQL). DQL: мощный язык, похожий на SQL, для запросов к заметкам Obsidian на основе метаданных (frontmatter, inline-поля), тегов, папок, ссылок, свойств файлов (имя, путь, даты) и задач. Используйте его, чтобы фильтровать, сортировать, группировать и преобразовывать данные из своего хранилища. Ключевое отличие от SQL: DQL выполняет запросы последовательно, строка за строкой, передавая результаты между командами. Это позволяет использовать несколько шагов where, sort или group by, в отличие от декларативного SQL. Поиск людей/имен: - поиск по названиям заметок: table file.name where contains(file.name, "ben") - найти заметки, ссылающиеся на человека: list from [[Ben]] - поиск по тегу человека: list from #person/ben Частые шаблоны: - получить метаданные заметки: table file.name, file.mtime from "NOTENAME" - поиск по тегу: list from #tag - поиск в папке: list from "folder/" - обратные ссылки: list from [[FILENAME]] - все заметки: list from "" Этот инструмент особенно хорош для поиска связей между заметками, метаданных и структурированных запросов. Используйте его, когда простой текстовый поиск не находит нужное. Полный синтаксис см. в документации Dataview: https://blacksmithgu.github.io/obsidian-dataview/

Параметры

querystringобязательный
dataview query language (dql) query string to execute. examples for finding people/names: - search note titles: "table file.name where contains(file.name, "ben")" - find backlinks: "list from [[Ben]]" - search by tags: "list from #person" - all notes: "list from """ common patterns: - list all notes: "list from """ - get specific note: "table file.name, file.mtime from "NOTENAME"" - find notes with tag: "list from #tag" - notes in folder: "list from "folder/"" - notes linking to file: "list from [[FILENAME]]" see https://blacksmithgu.github.io/obsidian-dataview/ for full syntax

obsidian_fuzzy_search

нечёткий поиск заметок с использованием приблизительного сопоставления. работает даже когда недоступен Obsidian API. отлично подходит для поиска заметок, если вы не уверены в точном написании или формулировке.

Параметры

max_resultsnumber
maximum number of results to return (default: 10)
querystringобязательный
search query for fuzzy matching

obsidian_get_file_content

Извлекает полное содержимое конкретного файла из Obsidian Vault.

Параметры

filepathstringобязательный
path to the file relative to the vault root (e.g., 'notes/my important note.md')

obsidian_graph_search

Анализирует ссылки и связи между заметками. Находит заметки-сироты, строит графы ссылок и обнаруживает взаимосвязи заметок. Работает без Obsidian API.

Параметры

include_orphansboolean
include notes with no links (default: false)
max_depthnumber
maximum depth for connection traversal (default: 2)
start_filestring
optional starting file to analyze connections from

obsidian_list_files

Перечисляет файлы и папки в указанной директории в хранилище Obsidian. Если директория не указана, перечисляет элементы в корне хранилища.

Параметры

directory_pathstring
optional path to a directory relative to the vault root (e.g., 'projects/active'). if omitted, lists files and folders in the vault root.
max_itemsnumber
maximum number of items to return (default: 50, max: 100). helps prevent token overflow in large directories
offsetnumber
number of items to skip for pagination (default: 0). use with max_items to paginate through large directories
sort_byenum
sort criteria for the results (default: 'name')
sort_orderenum
sort order for the results (default: 'asc')

obsidian_simple_search

Простой поиск документов, соответствующих заданному текстовому запросу, по всем файлам в хранилище. Используйте этот инструмент, когда хотите выполнить простой текстовый поиск

Параметры

context_lengthnumber
how much context to return around the matching string (default: 100, max: 2000)
max_resultsnumber
maximum number of results to return (default: 20, max: 100). helps prevent token overflow
offsetnumber
number of results to skip for pagination (default: 0). use with max_results to paginate through results
querystringобязательный
text to search for in the vault. searches across all file content. case-insensitive.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@louis030195/mcp-obsidian"
  ],
  "env": {
    "OBSIDIAN_API_KEY": "your-api-key-here"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот сервер соединяет AI-помощников с хранилищем Obsidian. Он позволяет Claude, ChatGPT и другим моделям искать заметки, читать их и анализировать связи между ними, даже если в запросе опечатки. Так AI получает прямой доступ к личной базе знаний пользователя и может отвечать на вопросы на основе его записей, находить потерянные файлы или выполнять Dataview-запросы — без копирования текста вручную.

Что он умеет?

Подключает Claude, ChatGPT и других AI-ассистентов к хранилищу Obsidian. Ищет заметки по нечёткому запросу. Выполняет простой текстовый поиск. Запускает Dataview-запросы. Читает содержимое конкретных файлов. Перечисляет файлы и папки в указанной директории. Анализирует граф связей между заметками, находит осиротевшие заметки.