A
licenseNot graded
qualityA
maintenanceEnables interaction between LLMs and Obsidian vaults through the Model Context Protocol, supporting secure file operations, content management, and advanced search capabilities.
3,971 npm
702
Apache 2.0
Obsidian MCP Server
by justice8096
Allows reading, writing, searching, and managing an Obsidian vault as a native tool.
Click on "Deploy 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., "@Obsidian MCP Server read the note 'Project Plan'"
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.
Obsidian MCP Server
An MCP server that lets Claude (and other MCP clients) read, write, search, and manage an Obsidian vault as a native tool. Local filesystem access only, no cloud sync.
Tools
Tool | Description | Read-only |
| Read a note's full markdown content | yes |
| Create or overwrite a note (refuses overwrite unless asked) | no |
| Append markdown to a note, creating it if missing | no |
| List notes in the vault or a folder | yes |
| Case-insensitive full-text search with line context | yes |
| Parse a note's YAML frontmatter as structured data | yes |
| Extract and resolve | yes |
All paths are relative to the vault root. The .md extension is optional.
Paths are validated to stay inside the vault (no directory traversal).
Related MCP server: Obsidian MCP Server
Setup
npm install
npm run buildThe vault location is set with the OBSIDIAN_VAULT_PATH environment variable.
If unset, it defaults to ~/Obsidian.
Configure in an MCP client
Add to your client's MCP config (example for a stdio client):
{
"mcpServers": {
"obsidian": {
"command": "node",
"args": ["/path/to/obsidian-mcp-server/dist/index.js"],
"env": {
"OBSIDIAN_VAULT_PATH": "/path/to/your/vault"
}
}
}
}Develop
npm run dev # run from source with tsx
npm run typecheck # type-check without emitting
npm run inspect # launch the MCP Inspector against the serverRoadmap
Semantic/vector search (embed notes, query by meaning)
Dataview query passthrough
Template-aware note creation
Backlink graph traversal
License
MIT
Available Tools
7 toolsobsidian_append_to_noteAppend to Obsidian NoteA
Append markdown to the end of a note, creating it if it does not exist. A newline is inserted before appended content when the note already has content.
Inputs: path (required), content (required).
obsidian_list_notesList Obsidian NotesARead-onlyIdempotent
List markdown notes in the vault, optionally scoped to a folder. Hidden folders (.obsidian, .git) are skipped. Read-only.
Inputs: folder, recursive.
obsidian_read_frontmatterRead Note FrontmatterARead-onlyIdempotent
Parse and return the YAML frontmatter of a note as structured data, plus a short body preview. Read-only.
Inputs: path (required).
obsidian_read_noteRead Obsidian NoteARead-onlyIdempotent
Read the full markdown content of a note in the vault. Path is relative to the vault root; the .md extension is optional. Read-only.
Inputs: path (required).
obsidian_resolve_wikilinksResolve Note WikilinksARead-onlyIdempotent
Extract [[wikilinks]] from a note and resolve each to an actual vault file by basename. Handles [[Note|alias]] and [[Note#heading]]. Unresolved links return target=null. Read-only.
Inputs: path (required).
obsidian_search_vaultSearch Obsidian VaultARead-onlyIdempotent
Case-insensitive full-text search across note bodies. Returns matching file path, line number, and the matching line. Read-only.
Inputs: query (required), limit, folder.
obsidian_write_noteWrite Obsidian NoteADestructive
Create a new note or overwrite an existing one. Refuses to overwrite unless overwrite=true. Parent folders are created automatically.
Inputs: path (required), content (required), overwrite.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
A4.2/5.0
Scored across 7 tools
Disambiguation5/5
Each tool has a clearly distinct purpose: reading, writing, appending, listing, searching, reading frontmatter, and resolving wikilinks. No overlap or ambiguity between tools.
Naming Consistency5/5
All tools follow the consistent pattern 'obsidian_verb_noun' in snake_case, e.g., obsidian_read_note, obsidian_write_note. Naming is predictable and uniform.
Tool Count4/5
7 tools is a reasonable count for a note-taking vault server. It covers essential operations, though a delete note tool is missing, which slightly reduces appropriateness.
Completeness4/5
The set covers reading, writing, appending, listing, searching, frontmatter parsing, and wikilink resolution. Missing delete note functionality is a minor gap but core workflows are achievable.
Maintenance
ActivityInactive
ResponsivenessNo recent community issues
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Search your Obsidian vault to quickly find notes by title or keyword, summarize related content, a…
Search, read, and safely update Markdown notes in your connected Phasoric knowledge vaults.
Personal context for every AI: search, read, and write back to your private Markdown library.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Obsidian vaults through vector search, vault indexing, and file monitoring. It provides a standardized interface for searching and managing markdown-based personal knowledge management data within the Model Context Protocol.3,971 npm1MIT
- FlicenseNot gradedqualityBmaintenanceEnables semantic search and note management for Obsidian vaults via the Model Context Protocol, allowing LLMs to search, read, and index notes, PDFs, and web pages locally.-
- AlicenseBqualityDmaintenanceEnables AI to manage Obsidian notes, including creation, reading, updating, deletion, full-text search, listing with filtering, sorting, and metadata extraction via the Model Context Protocol.814 npmMIT