Skip to main content
Glama
Obsidian MCP

Obsidian MCP

by takuya0206

Obsidian MCP(모델 컨텍스트 프로토콜)

Obsidian MCP는 모델 컨텍스트 프로토콜(MCP)을 사용하여 Obsidian 볼트와 상호작용할 수 있는 도구입니다. 이를 통해 AI 비서가 표준화된 인터페이스를 통해 Obsidian 볼트의 메모를 읽고, 쓰고, 조작할 수 있습니다.

필수 조건

Related MCP server: Obsidian MCP Server Plugin

MCP 서버 설정(예: Claude Desktop App)

  1. 이 저장소를 복제하세요

  2. 종속성 설치:

    지엑스피1

  3. 프로젝트를 빌드하세요:

    npm run build
  4. 이 MCP 서버를 사용하도록 Claude Desktop App을 구성하세요.

    {
       "mcpServers": {
         "Obsidian": {
           "command": "node",
           "args": ["/Users/<Your Own Path>/obsisian-mcp/build/index.js"],
           "env": {
             "apiKey": "<Your API Token>",
             "port": "27123",
             "host": "127.0.0.1"
           }
         }
       }
     }

개발

위에서 언급한 대로 .env 생성하고 "apiKey", "port", "host"를 구성합니다.

사용 가능한 도구

다음 도구가 구현되었습니다.

  1. readNote - 특정 노트의 내용을 읽습니다.

    {
      "path": "path/to/note.md"
    }
  2. readActiveNote - 현재 활성 노트의 내용을 읽습니다.

    {}
  3. listNotes - 전체 Vault 또는 지정된 폴더 아래의 파일과 폴더를 재귀적으로 나열합니다.

    {
      "path": "optional/folder/path"
    }
  4. patchNote - 제목, 블록 참조 또는 프런트매터 필드를 기준으로 기존 노트에 콘텐츠를 삽입합니다.

    {
      "path": "path/to/note.md",
      "operation": "append|prepend|replace",
      "targetType": "heading|block|frontmatter",
      "target": "target_identifier",
      "content": "content to insert"
    }
  5. searchWithJsonLogic - JsonLogic 형식 쿼리를 사용하여 Obsidian 노트 검색

    {
      "query": {
        // JsonLogic query object
      }
    }

Available Tools

5 tools
listNotesA

Recursively lists files and folders in the entire Vault or under a specified folder and returns the result as a tree-format string

Inputs: path.

patchNoteC

Inserts content into an existing note relative to a heading, block reference, or frontmatter field.

Inputs: path (required), operation (required), targetType (required), target (required), +4 more.

readActiveNoteB

Read the contents of the current active note

Inputs: no named parameters.

readNoteC

Read the contents of a specific note

Inputs: path (required).

searchWithJsonLogicB

Search Obsidian notes using JsonLogic format queries. Using logical conditions expressed in JSON, you can flexibly filter note metadata and content. Suitable for programmatically generated searches, allowing complex conditions to be expressed in a structured way.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 5 tools

    Disambiguation4/5

    Most tools have distinct purposes: listNotes for browsing, readNote/readActiveNote for reading, patchNote for editing, and searchWithJsonLogic for querying. However, readNote and readActiveNote could potentially be confused as they both read notes, though one targets a specific note and the other the active note, which is clarified in their descriptions.

    Naming Consistency3/5

    The naming is mixed: listNotes, readNote, and searchWithJsonLogic follow a verb_noun pattern, but patchNote uses a verb_noun format with a different verb style, and readActiveNote includes an adjective, breaking consistency. While readable, it lacks a uniform convention across all tools.

    Tool Count4/5

    With 5 tools, the count is reasonable for an Obsidian vault management server, covering core operations like listing, reading, editing, and searching notes. It's slightly lean but functional, as it includes essential CRUD-like actions without being overwhelming.

    Completeness3/5

    The tool set covers reading, editing, listing, and searching notes, but lacks explicit create and delete operations for notes, which are common in file-based systems. This creates gaps in full lifecycle management, though patchNote can modify existing notes and agents might work around missing create/delete by other means.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Turns an Obsidian vault into a local Model Context Protocol server that allows AI tools to directly read, search, and write to your notes. It features folder-level access control and a built-in dashboard for easy integration with tools like Claude Desktop and Cursor.
      2
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      A Model Context Protocol (MCP) server that provides AI assistants with secure access to Obsidian vaults. Enables reading, writing, searching, and managing notes without requiring Obsidian to be running.
      50
      7,721 npm
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides tools and resources for AI models to interact with an Obsidian vault, enabling file operations, search, and management via the Model Context Protocol.
      2
      -