Skip to content
MCP server

vaultguard

AI agents use your Obsidian secrets by name — values never reach their context.

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

About vaultguard

vaultguard is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add vaultguard --env VAULTGUARD_PASSPHRASE='<VAULTGUARD_PASSPHRASE>' -- npx -y @ashishrao-4/vaultguard

Add to claude_desktop_config.json

{
  "mcpServers": {
    "vaultguard": {
      "command": "npx",
      "args": [
        "-y",
        "@ashishrao-4/vaultguard"
      ],
      "env": {
        "VAULTGUARD_PASSPHRASE": "<VAULTGUARD_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vaultguard": {
      "command": "npx",
      "args": [
        "-y",
        "@ashishrao-4/vaultguard"
      ],
      "env": {
        "VAULTGUARD_PASSPHRASE": "<VAULTGUARD_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "vaultguard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ashishrao-4/vaultguard"
      ],
      "env": {
        "VAULTGUARD_PASSPHRASE": "<VAULTGUARD_PASSPHRASE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "vaultguard": {
      "command": "npx",
      "args": [
        "-y",
        "@ashishrao-4/vaultguard"
      ],
      "env": {
        "VAULTGUARD_PASSPHRASE": "<VAULTGUARD_PASSPHRASE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "vaultguard": {
      "command": "npx",
      "args": [
        "-y",
        "@ashishrao-4/vaultguard"
      ],
      "env": {
        "VAULTGUARD_PASSPHRASE": "<VAULTGUARD_PASSPHRASE>"
      }
    }
  }
}

Configuration

  • VAULTGUARD_PASSPHRASEPassphrase that decrypts the encrypted secret blocks in your Obsidian vault.Required
  • VAULTGUARD_VAULT_PATHPath to your Obsidian vault (overrides the one in ~/.vaultguard/config.json).
  • VAULTGUARD_HOMEConfig directory (defaults to ~/.vaultguard).
  • VAULTGUARD_ALLOW_GET_SECRETSet to 1 to enable get_secret (default: disabled so values never reach the agent).

Pricing

Open source

vaultguard FAQ

Is vaultguard free?

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

How do I add vaultguard to Claude Code?

Run this command in your terminal: claude mcp add vaultguard --env VAULTGUARD_PASSPHRASE='<VAULTGUARD_PASSPHRASE>' -- npx -y @ashishrao-4/vaultguard