Skip to content
VS Code

Notes Vault for VS Code

io.github.gronare/notes-vault-mcp

Indexed search, schema-checked writes and session hooks for a markdown notes vault

client:VS Code transport:stdio runtime:pypi

Install Notes Vault in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "vault-path",
      "description": "VAULT_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-endpoint",
      "description": "S3_ENDPOINT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-access-key",
      "description": "S3_ACCESS_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-secret-key",
      "description": "S3_SECRET_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-bucket",
      "description": "S3_BUCKET",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-prefix",
      "description": "S3_PREFIX",
      "password": true
    },
    {
      "type": "promptString",
      "id": "s3-region",
      "description": "S3_REGION",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vault-cache-dir",
      "description": "VAULT_CACHE_DIR",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vault-schema",
      "description": "VAULT_SCHEMA",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vault-token",
      "description": "VAULT_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vault-stop-hook",
      "description": "VAULT_STOP_HOOK",
      "password": true
    }
  ],
  "servers": {
    "notes-vault-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "${input:vault-path}",
        "S3_ENDPOINT": "${input:s3-endpoint}",
        "S3_ACCESS_KEY": "${input:s3-access-key}",
        "S3_SECRET_KEY": "${input:s3-secret-key}",
        "S3_BUCKET": "${input:s3-bucket}",
        "S3_PREFIX": "${input:s3-prefix}",
        "S3_REGION": "${input:s3-region}",
        "VAULT_CACHE_DIR": "${input:vault-cache-dir}",
        "VAULT_SCHEMA": "${input:vault-schema}",
        "VAULT_TOKEN": "${input:vault-token}",
        "VAULT_STOP_HOOK": "${input:vault-stop-hook}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

Notes Vault in other clients