Skip to content
MCP server

Vault MCP Tools

Complete Obsidian vault MCP server. 35 tools: notes, search, graph, tags, canvas.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.1
Listing updated
4 days ago

About Vault MCP Tools

Vault MCP Tools is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add vault-mcp-tools --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env OBSIDIAN_REST_TOKEN='<OBSIDIAN_REST_TOKEN>' --env OBSIDIAN_HTTP_AUTH_TOKEN='<OBSIDIAN_HTTP_AUTH_TOKEN>' -- npx -y vault-mcp-tools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "vault-mcp-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "vault-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "vault-mcp-tools"
      ],
      "env": {
        "OBSIDIAN_VAULT_PATH": "<OBSIDIAN_VAULT_PATH>",
        "OBSIDIAN_REST_TOKEN": "<OBSIDIAN_REST_TOKEN>",
        "OBSIDIAN_HTTP_AUTH_TOKEN": "<OBSIDIAN_HTTP_AUTH_TOKEN>"
      }
    }
  }
}

Configuration

  • OBSIDIAN_VAULT_PATHAbsolute path to the Obsidian vault root directoryRequired
  • OBSIDIAN_REST_TOKENBearer token for the Obsidian REST API (enables 3 bonus tools: execute_command, list_commands, open_in_obsidian)
  • OBSIDIAN_REST_PORTREST API port (default: 27124)
  • OBSIDIAN_TRANSPORTTransport mode: stdio (default) or http
  • OBSIDIAN_HTTP_PORTHTTP transport port (default: 3000)
  • OBSIDIAN_HTTP_AUTH_TOKENBearer token for HTTP transport authentication

Pricing

Open source

Vault MCP Tools FAQ

Is Vault MCP Tools free?

Yes. Vault MCP Tools is open source, so you can use and self-host it for free.

How do I add Vault MCP Tools to Claude Code?

Run this command in your terminal: claude mcp add vault-mcp-tools --env OBSIDIAN_VAULT_PATH='<OBSIDIAN_VAULT_PATH>' --env OBSIDIAN_REST_TOKEN='<OBSIDIAN_REST_TOKEN>' --env OBSIDIAN_HTTP_AUTH_TOKEN='<OBSIDIAN_HTTP_AUTH_TOKEN>' -- npx -y vault-mcp-tools

What are the best alternatives to Vault MCP Tools?

The closest alternatives to Vault MCP Tools are REA, Codebase Memory, XERJ, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to Vault MCP Tools

  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