Skip to content
VS Code

Obsidian MCP Server for VS Code

io.github.maxkuminov/obsidian-mcp

Self-hosted agent memory in an Obsidian vault: hybrid search, link graph, tasks, safe writes, OAuth

client:VS Code transport:stdio runtime:oci

Install Obsidian MCP Server in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "database-url",
      "description": "DATABASE_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vault-path",
      "description": "VAULT_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "secret-key",
      "description": "SECRET_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "mcp-hostname",
      "description": "MCP_HOSTNAME",
      "password": true
    },
    {
      "type": "promptString",
      "id": "embedding-provider",
      "description": "EMBEDDING_PROVIDER",
      "password": true
    },
    {
      "type": "promptString",
      "id": "ollama-url",
      "description": "OLLAMA_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "openai-api-key",
      "description": "OPENAI_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tei-url",
      "description": "TEI_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tei-embedding-model",
      "description": "TEI_EMBEDDING_MODEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tei-embed-batch-size",
      "description": "TEI_EMBED_BATCH_SIZE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tei-api-key",
      "description": "TEI_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "obsidian-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/maxkuminov/obsidian-mcp:v1.5.0"
      ],
      "env": {
        "DATABASE_URL": "${input:database-url}",
        "VAULT_PATH": "${input:vault-path}",
        "SECRET_KEY": "${input:secret-key}",
        "MCP_HOSTNAME": "${input:mcp-hostname}",
        "EMBEDDING_PROVIDER": "${input:embedding-provider}",
        "OLLAMA_URL": "${input:ollama-url}",
        "OPENAI_API_KEY": "${input:openai-api-key}",
        "TEI_URL": "${input:tei-url}",
        "TEI_EMBEDDING_MODEL": "${input:tei-embedding-model}",
        "TEI_EMBED_BATCH_SIZE": "${input:tei-embed-batch-size}",
        "TEI_API_KEY": "${input:tei-api-key}"
      }
    }
  }
}

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

Obsidian MCP Server in other clients