Obsidian MCP

Obsidian MCP is an MCP server that enables AI assistants like Claude Desktop to connect directly to an Obsidian vault via the Model Context Protocol. By interfacing with the Obsidian Local REST API plugin over local HTTP, it allows researchers, note-takers, and knowledge workers to query and manipulate their Markdown notes using automated agents. Users can read entire documents, retrieve the contents of the currently active note in the Obsidian interface, and recursively inspect folder hierarchies across the vault. The server also supports targeted edits through note patching, which lets assistants prepend, append, or replace text under specific headings, frontmatter keys, or block references without modifying unrelated sections. Additionally, the server exposes structured note search capabilities using JsonLogic queries, giving language models a standardized mechanism to filter and surface relevant personal knowledge files during complex reasoning and drafting workflows.

Category: Files, Documents & PDFs

Tags: knowledge-base, markdown, notes, obsidian

Visit Obsidian MCP

How to install and configure Obsidian MCP

1. Ensure Node.js 18 or higher is installed, and install the Local REST API plugin in Obsidian to generate an API key. 2. Clone the repository: bash git clone https://github.com/takuya0206/obsidian-mcp cd obsidian-mcp 3. Install dependencies and build the server: bash npm install npm run build 4. Add the server to your Claude Desktop configuration file: json { "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" } } } } 5. Replace the file path and API token with your local setup values and restart Claude Desktop.

What you can do with Obsidian MCP

• Reading the active note in Obsidian to provide immediate context, editing suggestions, or summaries within Claude. * Appending research summaries or action items under specific headings in markdown documents using targeted note patching. * Recursively scanning vault directories to map personal knowledge files, project notes, or nested folders for agent queries. * Running structured JsonLogic queries across vault notes to locate documents matching specific metadata or content rules.

Key facts

• Open Source
• https://github.com/takuya0206/obsidian-mcp
• Files, Documents & PDFs, Notes & Knowledge Management
• knowledge-base, markdown, notes, obsidian

Part of MCP Servers

What is Obsidian MCP?

Obsidian MCP is a Model Context Protocol server that allows AI assistants to interface directly with an Obsidian knowledge vault. It enables AI tools to list directories, read documents, patch sections of markdown notes, and search vault content via the Obsidian Local REST API.

What prerequisites are needed to run Obsidian MCP?

You need Node.js version 18 or higher, the Obsidian desktop application, and the Obsidian Local REST API plugin installed. The plugin generates the API key and hosts the local server on your machine so the MCP server can communicate with your vault.

What tools are available in Obsidian MCP?

The server includes five primary tools: readNote to read a file by path, readActiveNote to inspect the currently open note, listNotes to list vault files recursively, patchNote to modify specific headings or frontmatter, and searchWithJsonLogic to query notes.

Is Obsidian MCP open source?

Yes, Obsidian MCP is an open-source project hosted on GitHub under the repository takuya0206/obsidian-mcp. Anyone can clone the repository, inspect the code, build the project locally, and configure it for personal MCP setups.