Skip to main content
Glama
Obsidian MCP Local

Obsidian MCP Local

Obsidian MCP Local

Node.js + TypeScriptで構築されたMCPローカルサーバーで、ObsidianボルトをVS Code + GitHub Copilotに公開します。

ボルト内のMarkdownノートの読み書きに焦点を当て、stdioを介したローカルでの使用を想定しています。

インストール

npm install -g obsidian-mcp-local

Related MCP server: Obsidian MCP Server

機能

利用可能なツール

  • search_notes(query)

    • ノートのパス、フロントマター、コンテンツ内のテキストを検索します

    • 小さな抜粋を含むランク付けされた結果を返します

  • get_note(path)

    • ボルトからノートを開きます

    • path、frontmatter、contentを返します

  • create_note(path, content, overwrite?)

    • 新しいノートを作成します

    • オプションで既存のノートを上書きします

  • append_to_note(path, content)

    • 既存のノートの末尾にコンテンツを追加します

  • find_by_tag(tag)

    • タグでノートを検索します

    • フロントマターのtagsおよびコンテンツ内のインラインタグをサポートします

実装されているルール

  • 設定されたボルト内のファイルのみにアクセスします

  • 以下のディレクトリを無視します:

    • .obsidian

    • .git

    • node_modules

  • .mdファイルのみを扱います

  • ベースディレクトリ外へのアクセスを防ぐためにパスを正規化します

プロジェクト構造

obsidian-mcp-local/
  package.json
  tsconfig.json
  README.md
  .vscode/
    mcp.example.json
  src/
    index.ts

前提条件

  • Node.js 20+

  • npm

  • GitHub Copilotを搭載したVS Code

  • ローカルのObsidianボルト

インストール

プロジェクトディレクトリにて:

npm install
npm run build

開発用:

npm run dev

コンパイル済みバージョンの実行:

npm start

VS Codeでの使用方法

1. プロジェクトのコンパイル

npm install
npm run build

2. VS CodeのMCPファイルの設定

Copilotを使用するワークスペースの.vscode/mcp.jsonに、.vscode/mcp.example.jsonの内容をコピーします。

例: ローカルで使用する場合:

{
  "servers": {
    "obsidian-local-vault": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/caminho/para/obsidian-mcp-local/dist/index.js"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

npx経由で使用する場合(ローカルビルド不要):

{
  "servers": {
    "obsidian-local-vault": {
      "command": "npx",
      "args": ["-y", "obsidian-mcp-local"],
      "env": {
        "OBSIDIAN_VAULT_PATH": "D:/Obsidian/Vault"
      }
    }
  }
}

3. パスの更新

以下を置き換えてください:

  • C:/caminho/para/obsidian-mcp-local/dist/index.js

  • D:/Obsidian/Vault

これらを実際の環境のパスに書き換えてください。

4. VS Codeの再起動/リロード

その後、CopilotがMCPサーバーを検出するはずです。

Copilot Chatでの使用例

  • 「ボルトから.NETに関するノートを探して」

  • 「ノート knowledge/backend/dotnet.md を開いて」

  • 「議論した内容の要約を inbox/ideias-mcp.md に作成して」

  • 「ノート daily/2026-04-06.md の末尾に - testar MCP local を追加して」

  • 「タグ #arquitetura が付いたノートを見つけて」

今後の改善の可能性

  • append_under_heading

  • [[wikilinks]] の解析

  • get_backlinks(note)

  • 高速検索のためのSQLiteインデックス

  • 書き込み用フォルダのホワイトリスト (inbox/, daily/, scratch/)

  • 特定フォルダへの書き込み制限設定

重要な注意点

  • このプロジェクトはObsidianが起動している必要はありません。

  • ボルトのファイルに対して直接操作を行います。

  • ObsidianとVS Codeの両方で書き込みを有効にする場合、競合制御はユーザーの責任となります。

  • 現在のプロジェクトは、ボルトがローカルのMarkdownフォルダであることを前提としています。

メインファイル

実装は以下にあります:

  • src/index.ts

ライセンス

個人利用 / カスタマイズ用のベースとして。

Available Tools

5 tools
append_to_noteD

Inputs: path (required), content (required).

create_noteD

Inputs: path (required), content (required), overwrite.

find_by_tagD

Inputs: tag (required).

get_noteD

Inputs: path (required).

search_notesD

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    C2.1/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool name clearly indicates a distinct operation: create, get, append, search, and find by tag. No significant overlap is apparent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_note, search_notes), making the set predictable.

    Tool Count5/5

    Five tools cover essential note operations (create, retrieve, modify, search, tag) without unnecessary bloat or deficiency for the domain.

    Completeness3/5

    The set includes create, read, update (via append), and search operations but lacks a delete operation, which is a notable gap for a complete CRUD surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables direct file system access to Obsidian vaults with auto-discovery, full-text search, and note operations. Supports reading, writing, and searching across Obsidian notes without requiring plugins or REST API.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Obsidian vaults through direct filesystem access, supporting note management, lightning-fast search with SQLite indexing, image analysis, tag/link management, and bulk operations.
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to read, write, search, and navigate Obsidian vault notes with support for CRUD operations, full-text search, graph navigation, daily notes, and frontmatter management.
      3,713 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with local Obsidian vaults through direct filesystem access for reading, creating, and managing notes. It features high-performance SQLite indexing for fast searches, regex support, and tools for organizing tags and links without requiring additional plugins.
      27
      1
      MIT