Obsidian Vault MCP
Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.
- Pricing
- Open source
- Runs
- Locally
- Version
- 3.0.2
- Listing updated
- 4 days ago
About Obsidian Vault MCP
Obsidian Vault MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add obsidian-vault-mcp --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx zotero-obsidian-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"obsidian-vault-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"obsidian-vault-mcp": {
"command": "uvx",
"args": [
"zotero-obsidian-mcp"
],
"env": {
"OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>"
}
}
}
}Configuration
OBSIDIAN_VAULT_PATHAbsolute path to the Obsidian vault, or auto when the client project is inside it.Required
Pricing
Open source
Obsidian Vault MCP FAQ
Is Obsidian Vault MCP free?
Yes. Obsidian Vault MCP is open source, so you can use and self-host it for free.
How do I add Obsidian Vault MCP to Claude Code?
Run this command in your terminal: claude mcp add obsidian-vault-mcp --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' -- uvx zotero-obsidian-mcp
What are the best alternatives to Obsidian Vault MCP?
The closest alternatives to Obsidian Vault MCP are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.
Alternatives to Obsidian Vault MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools