obsidian-mcp
The Obsidian MCP Module is a server that facilitates accessing and reading notes from Obsidian vaults. It includes features for searching and retrieving note content, requiring specific tools and plugins for operation.
Obsidian MCP Module
This module provides an MCP server for reading Obsidian vaults.
Currently both MCP tools and resources exist for accessing notes since some clients only support one or the other (VS Code only support tools).
Features
search-notes
: Search notes by topicget-note
: Retrieve note contents
Installation
The Obsidian Metadata Extractor plugin needs to be enabled in order to create the metadata.json
file this MCP server uses.
VS Code
You'll need to add a .vscode/mcp.json
file to your workspace. Or you can set it up so all workspaces have access: https://code.visualstudio.com/docs/copilot/chat/mcp-servers.
{
"servers": {
"obsidian-mcp": {
"type": "stdio",
"command": "deno",
"args": [
"run",
"--allow-read",
"${workspaceFolder}/main.ts",
"--vaultPath=/path/to/vault"
]
}
}
}
Claude Desktop
{
"mcpServers": {
"filesystem": {
"command": "/path/to/deno",
"args": [
"run",
"--allow-read",
"/path/to/main.ts",
"--vaultPath=/path/to/vault"
]
}
}
}
License
This project is licensed under the MIT License. See the LICENSE file for details.