← Index

vault-cortex

io.github.aliasunder/vault-cortex·v0.15.4·Search
Quality Score
90
/100

MCP server for Obsidian vaults — search, memory, link graph, 23 tools, OAuth-protected.

§00  Trust verdict · v1 advisory ·  method
UNVERIFIEDno verdict on file

Verdict not yet evaluated for this tool. The hybrid eval runs adversarial cases first; coverage rolls out as the corpus expands. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: hybrid eval, four-state verdict, honest limits.

§01  Install
Claude Desktop (Docker)
{
  "mcpServers": {
    "vault-cortex": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/aliasunder/vault-mcp:0.15.4"
      ],
      "env": {
        "MCP_AUTH_TOKEN": "<your-mcp_auth_token>",
        "PUBLIC_URL": "http://localhost:8000",
        "MEMORY_DIR": "About Me",
        "TZ": "UTC",
        "LOG_LEVEL": "info",
        "LOG_DIR": "<log_dir>",
        "LOG_RETENTION_DAYS": "30",
        "PROTECTED_PATHS": "<protected_paths>",
        "ORPHAN_EXCLUDE_FOLDERS": "<orphan_exclude_folders>",
        "SERVICE_DOCUMENTATION_URL": "https://github.com/aliasunder/vault-cortex"
      }
    }
  }
}
§02  Environment variables
MCP_AUTH_TOKEN
requiredsecret

Bearer token for MCP client authentication. Must match the Authorization header sent by clients. Generate with: openssl rand -hex 32

PUBLIC_URL

Public URL clients use to reach this server. Used as the OAuth issuer URL in discovery metadata. Override when exposing the server outside localhost or on a non-default port.

MEMORY_DIR

Vault folder for structured memory files (About Me-style notes).

TZ

IANA timezone for timestamps and daily note resolution.

LOG_LEVEL

Logging verbosity.

LOG_DIR

Directory for persistent log files. Unset by default — logs go to stdout only. Set to /data/logs to also write date-stamped .log files to the persistent volume.

LOG_RETENTION_DAYS

Days to retain persistent log files before cleanup.

PROTECTED_PATHS

Comma-separated vault folder names blocked from vault_delete_note. Default: MEMORY_DIR and "Daily Notes".

ORPHAN_EXCLUDE_FOLDERS

Comma-separated vault folder names excluded from vault_find_orphans. Default: "Daily Notes", "Templates", MEMORY_DIR.

SERVICE_DOCUMENTATION_URL

Override the OAuth service documentation URL exposed via discovery metadata.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
20
installability
25
documentation
15
stability
5
§04  Alternatives in Search