Obsidian MCP

by takuya0206
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for interacting with Obsidian vaults, including reading notes, accessing the active note, listing files and folders, modifying notes with targeted insertions, and searching notes using JsonLogic queries.

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

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

前提条件

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 } }
-
security - not tested
A
license - permissive license
-
quality - not tested

AI アシスタントが標準化されたインターフェースを通じて Obsidian Vault 内のメモを読み取り、書き込み、操作できるようにするモデル コンテキスト プロトコル サーバー。

  1. Prerequisites
    1. Setting MCP Server (e.g. Claude Desktop App)
      1. Development
        1. Available Tools
      ID: lnk85kbz4o