Obsidian MCP
Obsidian MCP(モデルコンテキストプロトコル)
Obsidian MCPは、モデルコンテキストプロトコル(Model Context Protocol)を用いてObsidian Vaultとやり取りできるツールです。これにより、AIアシスタントは標準化されたインターフェースを介してObsidian Vault内のメモの読み取り、書き込み、操作が可能になります。
前提条件
Node.js 18以上
ローカル REST API プラグインがインストールおよび構成された Obsidian
ローカルREST APIプラグインから生成されたAPIキー
Related MCP server: Obsidian MCP Server Plugin
MCP サーバーの設定 (例: Claude デスクトップ アプリ)
このリポジトリをクローンする
依存関係をインストールします:
npm installプロジェクトをビルドします。
npm run buildこの 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」を設定します。
利用可能なツール
以下のツールが実装されています。
readNote - 特定のメモの内容を読む
{ "path": "path/to/note.md" }readActiveNote - 現在アクティブなノートの内容を読み取る
{}listNotes - Vault 全体または指定されたフォルダ内のファイルとフォルダを再帰的に一覧表示します
{ "path": "optional/folder/path" }patchNote - 見出し、ブロック参照、または前置フィールドを基準にして既存のノートにコンテンツを挿入します。
{ "path": "path/to/note.md", "operation": "append|prepend|replace", "targetType": "heading|block|frontmatter", "target": "target_identifier", "content": "content to insert" }searchWithJsonLogic - JsonLogic形式のクエリを使用してObsidianノートを検索します
{ "query": { // JsonLogic query object } }
Available Tools
5 toolslistNotesA
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
Scored across 5 tools
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.
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.
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.
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
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA server implementation that allows AI assistants to read, create, and manipulate notes in Obsidian vaults through the Model Context Protocol.914 npm6MIT
- AlicenseNot gradedqualityDmaintenanceTurns 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 npm2Apache 2.0
- AlicenseAqualityFmaintenanceA 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.504,522 npmApache 2.0
- FlicenseNot gradedqualityCmaintenanceMCP 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-