Skip to content
MCP server

Obsidian Vault MCP

Local Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  4. MCP 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
  5. Local-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
  6. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools