Overview
What is Obsidian MCP Module?
Obsidian MCP Module is an MCP server for reading Obsidian vaults. It provides both MCP tools and resources for accessing notes, since some clients only support one or the other.
How to use Obsidian MCP Module?
Enable the Obsidian Metadata Extractor plugin to create the required metadata.json file. Configure the server in your MCP client (VS Code or Claude Desktop) using the deno runtime, pointing to your vault path.
Key features of Obsidian MCP Module
search-notes: Search notes by topicget-note: Retrieve note contents- Supports both MCP tools and resources
- Works with VS Code and Claude Desktop
- Read-only access to vault files
Use cases of Obsidian MCP Module
- Searching for notes across an Obsidian vault by topic
- Retrieving the full contents of a specific note
- Enabling AI assistants to read and reference vault content
- Integrating Obsidian knowledge into MCP-compatible applications
FAQ from Obsidian MCP Module
What dependencies does Obsidian MCP Module require?
It requires the Deno runtime and the Obsidian Metadata Extractor plugin to be enabled in your vault.
What transport does Obsidian MCP Module use?
It uses the stdio transport and requires the --allow-read permission flag.
Where does Obsidian MCP Module store data?
It reads directly from the local vault path specified via the --vaultPath argument; no external data storage is used.
Does Obsidian MCP Module support writing notes?
No, the README explicitly states the server is for reading Obsidian vaults only.
How do I configure Obsidian MCP Module for VS Code?
Add an .vscode/mcp.json file to your workspace with the deno command, --allow-read flag, and --vaultPath pointing to your vault directory.
