Skip to main content
Glama
Obsidian MCP

Obsidian MCP

by takuya0206

Obsidian MCP(モデルコンテキストプロトコル)

Obsidian MCPは、モデルコンテキストプロトコル(Model Context Protocol)を用いてObsidian Vaultとやり取りできるツールです。これにより、AIアシスタントは標準化されたインターフェースを介してObsidian Vault内のメモの読み取り、書き込み、操作が可能になります。

前提条件

Related MCP server: Obsidian MCP Server Plugin

MCP サーバーの設定 (例: Claude デスクトップ アプリ)

  1. このリポジトリをクローンする

  2. 依存関係をインストールします:

    npm install
  3. プロジェクトをビルドします。

    npm run build
  4. この MCP サーバーを使用するように Claude デスクトップ アプリを構成します。

    {
       "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.

    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.
      4,522 npm
      2
      Apache 2.0
    • 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
      4,522 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
      -