Back to MCP Servers
🧩

Vault Cortex MCP Server

API key required

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

To add Vault Cortex to Claude, run the install command below. Restart Claude Code after adding it and its tools show up in your next conversation. It needs 24 environment variables, listed below.

SearchFilesDevTools

Install

docker run -i --rm ghcr.io/aliasunder/vault-cortex:0.55.5

Environment variables

MCP_AUTH_TOKENSet in your MCP config
PUBLIC_URLSet in your MCP config
EMBEDDING_ENABLEDSet in your MCP config
RERANK_MODESet in your MCP config
WINDOWS_MODESet in your MCP config
MEMORY_ENABLEDSet in your MCP config
FILE_TOOLS_ENABLEDSet in your MCP config
READONLY_MODESet in your MCP config
DISABLED_TOOLSSet in your MCP config
MEMORY_DIRSet in your MCP config
DAILY_NOTES_FOLDERSet in your MCP config
DAILY_NOTES_FORMATSet in your MCP config
TRUST_PROXY_HOPSSet in your MCP config
TRUST_FORWARDED_HOPSSet in your MCP config
TZSet in your MCP config
LOG_LEVELSet in your MCP config
LOG_DIRSet in your MCP config
LOG_RETENTION_DAYSSet in your MCP config
PROTECTED_PATHSSet in your MCP config
ORPHAN_EXCLUDE_FOLDERSSet in your MCP config
SERVICE_DOCUMENTATION_URLSet in your MCP config
MAX_FILE_BYTESSet in your MCP config
MAX_IMAGE_OUTPUT_BYTESSet in your MCP config
MAX_PDF_RENDER_PAGESSet in your MCP config

What this does

Vault Cortex exposes a set of tools to Claude over the Model Context Protocol. After you add it to claude_desktop_config.json (snippet above) and restart Claude Desktop, those tools become callable inside any conversation.

Requirements

This server needs the following environment variables to be set before it can run:

MCP_AUTH_TOKEN
PUBLIC_URL
EMBEDDING_ENABLED
RERANK_MODE
WINDOWS_MODE
MEMORY_ENABLED
FILE_TOOLS_ENABLED
READONLY_MODE
DISABLED_TOOLS
MEMORY_DIR
DAILY_NOTES_FOLDER
DAILY_NOTES_FORMAT
TRUST_PROXY_HOPS
TRUST_FORWARDED_HOPS
TZ
LOG_LEVEL
LOG_DIR
LOG_RETENTION_DAYS
PROTECTED_PATHS
ORPHAN_EXCLUDE_FOLDERS
SERVICE_DOCUMENTATION_URL
MAX_FILE_BYTES
MAX_IMAGE_OUTPUT_BYTES
MAX_PDF_RENDER_PAGES

Set these via the env object in your MCP config (see claude_desktop_config.json snippet above).

Frequently asked questions

How do I install Vault Cortex?

The install section on this page carries the maker's install command for Vault Cortex, as submitted. Restart your client afterwards and the tools appear in your next conversation.

Which clients work with Vault Cortex?

This page carries setup and config for Claude Code. Any other MCP client that accepts a standard server config can connect to Vault Cortex as well.

Does Vault Cortex need an API key?

Yes. Before it can run, set these environment variables: MCP_AUTH_TOKEN, PUBLIC_URL, EMBEDDING_ENABLED, RERANK_MODE, WINDOWS_MODE, MEMORY_ENABLED, FILE_TOOLS_ENABLED, READONLY_MODE, DISABLED_TOOLS, MEMORY_DIR, DAILY_NOTES_FOLDER, DAILY_NOTES_FORMAT, TRUST_PROXY_HOPS, TRUST_FORWARDED_HOPS, TZ, LOG_LEVEL, LOG_DIR, LOG_RETENTION_DAYS, PROTECTED_PATHS, ORPHAN_EXCLUDE_FOLDERS, SERVICE_DOCUMENTATION_URL, MAX_FILE_BYTES, MAX_IMAGE_OUTPUT_BYTES, MAX_PDF_RENDER_PAGES. They go in the env block of your MCP config.

Imported from the Official MCP Registry. The details above come from the registry entry; the maker can claim this listing to correct them, add docs, and see its traffic.

Is this your MCP server?

Claim this listing to see its traffic, fix details yourself, and skip the review queue on future updates.

Listed on clauderules.net

Add this badge to your README

Show visitors this server is listed in the ClaudeRules directory. The badge links straight to this listing.

Markdown
[![Listed on clauderules.net](https://clauderules.net/api/badge/io-github-aliasunder-vault-cortex)](https://clauderules.net/mcp/io-github-aliasunder-vault-cortex)
HTML
<a href="https://clauderules.net/mcp/io-github-aliasunder-vault-cortex" target="_blank" rel="noopener noreferrer"><img src="https://clauderules.net/api/badge/io-github-aliasunder-vault-cortex" alt="Listed on clauderules.net" /></a>