Skip to content
Zed

Vault Cortex for Zed

io.github.aliasunder/vault-cortex

Standalone MCP server for Obsidian vaults — hybrid search, notes & files, memory, tasks, OAuth 2.1

client:Zed transport:stdio runtime:oci

Install Vault Cortex in Zed

~/.config/zed/settings.json · windows: %APPDATA%\Zed\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "context_servers": {
    "vault-cortex": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/aliasunder/vault-cortex:0.54.2"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>",
        "PUBLIC_URL": "<PUBLIC_URL>",
        "EMBEDDING_ENABLED": "<EMBEDDING_ENABLED>",
        "RERANK_MODE": "<RERANK_MODE>",
        "WINDOWS_MODE": "<WINDOWS_MODE>",
        "MEMORY_ENABLED": "<MEMORY_ENABLED>",
        "FILE_TOOLS_ENABLED": "<FILE_TOOLS_ENABLED>",
        "READONLY_MODE": "<READONLY_MODE>",
        "DISABLED_TOOLS": "<DISABLED_TOOLS>",
        "MEMORY_DIR": "<MEMORY_DIR>",
        "DAILY_NOTES_FOLDER": "<DAILY_NOTES_FOLDER>",
        "DAILY_NOTES_FORMAT": "<DAILY_NOTES_FORMAT>",
        "TRUST_PROXY_HOPS": "<TRUST_PROXY_HOPS>",
        "TRUST_FORWARDED_HOPS": "<TRUST_FORWARDED_HOPS>",
        "TZ": "<TZ>",
        "LOG_LEVEL": "<LOG_LEVEL>",
        "LOG_DIR": "<LOG_DIR>",
        "LOG_RETENTION_DAYS": "<LOG_RETENTION_DAYS>",
        "PROTECTED_PATHS": "<PROTECTED_PATHS>",
        "ORPHAN_EXCLUDE_FOLDERS": "<ORPHAN_EXCLUDE_FOLDERS>",
        "SERVICE_DOCUMENTATION_URL": "<SERVICE_DOCUMENTATION_URL>",
        "MAX_FILE_BYTES": "<MAX_FILE_BYTES>",
        "MAX_IMAGE_OUTPUT_BYTES": "<MAX_IMAGE_OUTPUT_BYTES>",
        "MAX_PDF_RENDER_PAGES": "<MAX_PDF_RENDER_PAGES>"
      }
    }
  }
}

Merge this into your existing settings object — do not replace the file. Zed docs

Vault Cortex in other clients