mcp-obsidian
The mcp-obsidian server lets you read, write, and manage Markdown notes in an Obsidian vault directly on disk — no Obsidian app or plugin required.
Read notes (
obsidian_read): Retrieve a note's content with optional truncation to limit response size.Search notes (
obsidian_search): Perform case-insensitive keyword searches across notes, with options to restrict to a subfolder, set a result limit, and return context snippets around matches.Write/create notes (
obsidian_write): Create a new note or completely overwrite an existing one, automatically creating any necessary parent folders.Append to notes (
obsidian_append): Add Markdown content to the end of an existing note without altering the rest.Patch frontmatter (
obsidian_patch_frontmatter): Modify specific YAML frontmatter fields (strings, numbers, or arrays) in a note without touching the note body.List files and folders (
obsidian_list): List all.mdfiles and subfolders in a given directory, with an option for recursive listing of nested subdirectories.
Provides filesystem-based access to an Obsidian vault, enabling reading, writing, searching, and managing Markdown notes directly on disk.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-obsidianfind notes about project planning in my vault"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-obsidian
🇬🇧 English · 🇫🇷 Français
A filesystem-based MCP server for an Obsidian vault. It reads and writes your vault's Markdown files directly on disk — no Obsidian plugin, no Local REST API, no running Obsidian instance required. Point it at a folder and your LLM can browse and edit notes.
Why filesystem-based
Most Obsidian MCP servers talk to the Local REST API community plugin, which
means Obsidian must be running with the plugin enabled. mcp-obsidian skips all
that and operates on the vault directory itself — works headless, in CI, or on a
synced folder.
Related MCP server: Obsidian MCP Tool Server
Tools
Tool | Description |
| Read a note (with optional truncation) |
| Keyword search across notes, with truncated context per hit; optional subfolder scope |
| Create or overwrite a note (creates parent folders) |
| Append content to a note |
| Patch a note's YAML frontmatter |
| List |
All paths are relative to the vault root (e.g. wiki/cyber/sql-injection.md).
Scope
This server is transport only. It has no notion of a "claim", no conflict
detection and no merge policy — obsidian_write is a plain overwrite, last write
wins. Contradiction handling, note conventions and the human-in-the-loop review
step live one layer up, in
claude-obsidian-system.
Install
git clone https://github.com/NeveuGregor/mcp-obsidian.git
cd mcp-obsidian
npm install
npm run build # compiles TypeScript to dist/Configuration
The vault path is provided via the OBSIDIAN_VAULT environment variable
(absolute path). The server exits with an error if it is not set.
Register it with Claude (CLI or Desktop), e.g. in your MCP config:
{
"mcpServers": {
"obsidian": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/mcp-obsidian/dist/index.js"],
"env": {
"OBSIDIAN_VAULT": "/absolute/path/to/your/vault"
}
}
}
}Requirements
Node.js 18+
An Obsidian vault (just a folder of Markdown files)
Related
This server is the MCP layer of a broader knowledge architecture — claude-obsidian-system — which documents how the vault itself is designed (LLM-Wiki + Zettelkasten + Evergreen) and wired to Claude Code skills and memory.
License
CeCILL-B (BSD-compatible, French law) — © 2026 Neveu Grégor.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityFmaintenanceA local MCP server that enables AI applications like Claude Desktop to securely access and work with Obsidian vaults, providing capabilities for reading notes, executing templates, and performing semantic searches.Last updated832MIT
- Alicense-qualityDmaintenanceProvides an MCP server that allows AI assistants to interact with Obsidian vaults, enabling reading/writing notes, managing metadata, searching content, and working with daily notes.Last updated36MIT
- Flicense-qualityDmaintenanceA local MCP server that wraps the Obsidian CLI to give AI assistants direct access to read, edit, and manage notes within an Obsidian vault. It enables advanced operations such as frontmatter property management, context-aware searching, and the execution of internal Obsidian commands.Last updated2
- Alicense-qualityCmaintenanceMCP server that provides read and write access to an Obsidian vault by interacting directly with markdown files on disk. Supports searching, listing, reading, creating, editing, and appending notes without requiring any Obsidian plugins.Last updated3,424ISC
Related MCP Connectors
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/NeveuGregor/mcp-obsidian'
If you have feedback or need assistance with the MCP directory API, please join our Discord server