Markdown Vault MCP

io.github.pvliesdonk/markdown-vault-mcp · v6.1.1

Generic markdown vault MCP with hybrid search

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add markdown-vault-mcp -e MARKDOWN_VAULT_MCP_KV_STORE_URL=<MARKDOWN_VAULT_MCP_KV_STORE_URL> -e MARKDOWN_VAULT_MCP_TOOLS_ALLOW=<MARKDOWN_VAULT_MCP_TOOLS_ALLOW> -e MARKDOWN_VAULT_MCP_TOOLS_DENY=<MARKDOWN_VAULT_MCP_TOOLS_DENY> -e MARKDOWN_VAULT_MCP_SERVER_NAME=<MARKDOWN_VAULT_MCP_SERVER_NAME> -e MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION=<MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION> -e MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA=<MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA> -e MARKDOWN_VAULT_MCP_INSTRUCTIONS=<MARKDOWN_VAULT_MCP_INSTRUCTIONS> -e MARKDOWN_VAULT_MCP_LOG_LEVEL=<MARKDOWN_VAULT_MCP_LOG_LEVEL> -e MARKDOWN_VAULT_MCP_LOG_FORMAT=<MARKDOWN_VAULT_MCP_LOG_FORMAT> -e OLLAMA_HOST=<OLLAMA_HOST> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e VOYAGE_API_KEY=<VOYAGE_API_KEY> -e OPENAI_BASE_URL=<OPENAI_BASE_URL> -e OPENAI_EMBEDDING_MODEL=<OPENAI_EMBEDDING_MODEL> -e MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=<MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S> -e MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=<MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S> -e MARKDOWN_VAULT_MCP_SERVER_URL=<MARKDOWN_VAULT_MCP_SERVER_URL> -e MARKDOWN_VAULT_MCP_CLIENT_CONFIG=<MARKDOWN_VAULT_MCP_CLIENT_CONFIG> -e MARKDOWN_VAULT_MCP_CLIENT_TOKEN=<MARKDOWN_VAULT_MCP_CLIENT_TOKEN> -e MARKDOWN_VAULT_MCP_SOURCE_DIR=<MARKDOWN_VAULT_MCP_SOURCE_DIR> -e MARKDOWN_VAULT_MCP_READ_ONLY=<MARKDOWN_VAULT_MCP_READ_ONLY> -e MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=<MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING> -e MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=<MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS> -e MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=<MARKDOWN_VAULT_MCP_DISABLE_APPS_UI> -e MARKDOWN_VAULT_MCP_INDEX_PATH=<MARKDOWN_VAULT_MCP_INDEX_PATH> -e MARKDOWN_VAULT_MCP_STATE_PATH=<MARKDOWN_VAULT_MCP_STATE_PATH> -e MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH=<MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH> -e MARKDOWN_VAULT_MCP_EMBEDDING_STORE=<MARKDOWN_VAULT_MCP_EMBEDDING_STORE> -e MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH=<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH> -e MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB=<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB> -e MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN=<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN> -e MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA=<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA> -e MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE=<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE> -e MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S=<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S> -e MARKDOWN_VAULT_MCP_INDEXED_FIELDS=<MARKDOWN_VAULT_MCP_INDEXED_FIELDS> -e MARKDOWN_VAULT_MCP_REQUIRED_FIELDS=<MARKDOWN_VAULT_MCP_REQUIRED_FIELDS> -e MARKDOWN_VAULT_MCP_EXCLUDE=<MARKDOWN_VAULT_MCP_EXCLUDE> -e MARKDOWN_VAULT_MCP_TITLE_FIELD=<MARKDOWN_VAULT_MCP_TITLE_FIELD> -e MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS=<MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS> -e MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=<MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER> -e MARKDOWN_VAULT_MCP_PROMPTS_FOLDER=<MARKDOWN_VAULT_MCP_PROMPTS_FOLDER> -e MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=<MARKDOWN_VAULT_MCP_CONVENTIONS_FILE> -e MARKDOWN_VAULT_MCP_OKF_MODE=<MARKDOWN_VAULT_MCP_OKF_MODE> -e MARKDOWN_VAULT_MCP_OKF_WRITE=<MARKDOWN_VAULT_MCP_OKF_WRITE> -e MARKDOWN_VAULT_MCP_OKF_VERIFY=<MARKDOWN_VAULT_MCP_OKF_VERIFY> -e MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS=<MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS> -e MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS=<MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS> -e MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=<MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB> -e MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=<MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES> -e MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=<MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE> -e MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=<MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE> -e MARKDOWN_VAULT_MCP_SNIPPET_WORDS=<MARKDOWN_VAULT_MCP_SNIPPET_WORDS> -e MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=<MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA> -e MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=<MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS> -e MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS=<MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS> -e MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=<MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS> -e MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS=<MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS> -e MARKDOWN_VAULT_MCP_FTS_WEIGHTS=<MARKDOWN_VAULT_MCP_FTS_WEIGHTS> -e MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=<MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER> -e MARKDOWN_VAULT_MCP_OLLAMA_MODEL=<MARKDOWN_VAULT_MCP_OLLAMA_MODEL> -e MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=<MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY> -e MARKDOWN_VAULT_MCP_VOYAGE_MODEL=<MARKDOWN_VAULT_MCP_VOYAGE_MODEL> -e MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=<MARKDOWN_VAULT_MCP_OPENAI_BASE_URL> -e MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=<MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL> -e MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=<MARKDOWN_VAULT_MCP_FASTEMBED_MODEL> -e MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR=<MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR> -e MARKDOWN_VAULT_MCP_EMBED_CONTEXT=<MARKDOWN_VAULT_MCP_EMBED_CONTEXT> -e MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=<MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S> -e MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=<MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE> -e MARKDOWN_VAULT_MCP_GIT_TOKEN=<MARKDOWN_VAULT_MCP_GIT_TOKEN> -e MARKDOWN_VAULT_MCP_GIT_REPO_URL=<MARKDOWN_VAULT_MCP_GIT_REPO_URL> -e MARKDOWN_VAULT_MCP_GIT_USERNAME=<MARKDOWN_VAULT_MCP_GIT_USERNAME> -e MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=<MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S> -e MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=<MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S> -e MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME> -e MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL> -e MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM=<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM> -e MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM=<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM> -e MARKDOWN_VAULT_MCP_GIT_LFS=<MARKDOWN_VAULT_MCP_GIT_LFS> -e MARKDOWN_VAULT_MCP_FILE_WATCHER=<MARKDOWN_VAULT_MCP_FILE_WATCHER> -e MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=<MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S> -e MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=<MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR> -e MARKDOWN_VAULT_MCP_BOOT_REINDEX=<MARKDOWN_VAULT_MCP_BOOT_REINDEX> -e MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET=<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET> -e MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN=<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN> -e MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN=<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN> -e MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER=<MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER> -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY=<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY> -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL=<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL> -e MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL> -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS> -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES> -e MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS> -e MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=<MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT> -e MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=<MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S> -e MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=<MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S> -e MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=<MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S> -e MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=<MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S> -e MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=<MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES> -e MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=<MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S> -e MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=<MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S> -e MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=<MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT> -- uvx markdown-vault-mcp==6.1.1

claude_desktop_config.json

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==6.1.1"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<OLLAMA_HOST>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SERVER_URL": "<MARKDOWN_VAULT_MCP_SERVER_URL>",
        "MARKDOWN_VAULT_MCP_CLIENT_CONFIG": "<MARKDOWN_VAULT_MCP_CLIENT_CONFIG>",
        "MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<MARKDOWN_VAULT_MCP_CLIENT_TOKEN>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "<MARKDOWN_VAULT_MCP_EMBEDDING_STORE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS": "<MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==6.1.1"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<OLLAMA_HOST>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SERVER_URL": "<MARKDOWN_VAULT_MCP_SERVER_URL>",
        "MARKDOWN_VAULT_MCP_CLIENT_CONFIG": "<MARKDOWN_VAULT_MCP_CLIENT_CONFIG>",
        "MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<MARKDOWN_VAULT_MCP_CLIENT_TOKEN>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "<MARKDOWN_VAULT_MCP_EMBEDDING_STORE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS": "<MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "markdown-vault-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==6.1.1"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<OLLAMA_HOST>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SERVER_URL": "<MARKDOWN_VAULT_MCP_SERVER_URL>",
        "MARKDOWN_VAULT_MCP_CLIENT_CONFIG": "<MARKDOWN_VAULT_MCP_CLIENT_CONFIG>",
        "MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<MARKDOWN_VAULT_MCP_CLIENT_TOKEN>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "<MARKDOWN_VAULT_MCP_EMBEDDING_STORE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "<MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS": "<MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`MARKDOWN_VAULT_MCP_KV_STORE_URL` Optional	Persistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `mongodb://` each need their matching extra. When unset, defaults to `file:///data/state` (the volume…
`MARKDOWN_VAULT_MCP_TOOLS_ALLOW` Optional	Comma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_deny`. Takes effect through `apply_tool_visibility`.
`MARKDOWN_VAULT_MCP_TOOLS_DENY` Optional	Comma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effect through `apply_tool_visibility`.
`MARKDOWN_VAULT_MCP_SERVER_NAME` Optional	Rename this server instance; defaults to the project name.
`MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION` Optional	Concise routing context that distinguishes this deployment's material or responsibility.
`MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA` Optional	Deployment-specific behavioral policy added to the generated MCP instructions.
`MARKDOWN_VAULT_MCP_INSTRUCTIONS` Optional	Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
`MARKDOWN_VAULT_MCP_LOG_LEVEL` Optional	Log level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one major version and logs a deprecation warning.
`MARKDOWN_VAULT_MCP_LOG_FORMAT` Optional	Log rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere else, so a container or journald gets JSON with no configuration.
`OLLAMA_HOST` Optional	Ollama server URL for the ollama embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the Ollama ecosystem convention.
`OPENAI_API_KEY` Optional, secret	OpenAI API key for the openai embedding provider, and the fallback key for the summarize tool when MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY is unset. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OpenAI ecosystem convention.
`VOYAGE_API_KEY` Optional, secret	Voyage AI API key for the voyage embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OPENAI_API_KEY / OLLAMA_HOST convention. Setting it never auto-selects the provider; choose it explicitly with MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=voyage.
`OPENAI_BASE_URL` Optional	Bare fallback for MARKDOWN_VAULT_MCP_OPENAI_BASE_URL (embeddings). For the summarize tool it only routes traffic when an API key already enables the feature; it never enables summarize by itself.
`OPENAI_EMBEDDING_MODEL` Optional	Bare fallback for MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL.
`MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S` Optional	Maximum seconds an index-backed tool or resource waits for the FTS index to become queryable during a cold-start background build before raising IndexUnavailableError(reason="timeout"). Increase for large vaults.
`MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S` Optional	Maximum seconds an index-querying read tool waits for the IndexWriter to drain when called with wait_for_pending_writes=true. On timeout the tool answers from the current index and reports index_stale=true in the response _meta.
`MARKDOWN_VAULT_MCP_SERVER_URL` Optional	Hosted MCP endpoint for CLI reads. The explicit server option overrides it. Local mode bypasses it.
`MARKDOWN_VAULT_MCP_CLIENT_CONFIG` Optional	Client TOML profile path; defaults to XDG_CONFIG_HOME/markdown-vault-mcp/client.toml.
`MARKDOWN_VAULT_MCP_CLIENT_TOKEN` Optional, secret	Optional CLI bearer token. A nonempty value overrides the profile-selected token environment source; an empty value leaves that source in effect. Never stored in client TOML.
`MARKDOWN_VAULT_MCP_SOURCE_DIR` Optional	Path to the markdown vault directory. When it does not exist, or the server cannot access it, the server starts but every tool fails with a message saying which until it is fixed (managed git mode clones into it). Symbolic links inside the vault are followed on Python 3.13+.
`MARKDOWN_VAULT_MCP_READ_ONLY` Optional	Set to true to hide the write tools (write, edit, append, delete, rename, move_folder, fetch, git_sync, the okf_* tools, create_upload_link) and serve a search-only vault.
`MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING` Optional	Refuse a write that would overwrite an existing file when no if_match etag is supplied. Deliberate replacement still works: read the file first, then pass if_match. Unaffected: edit, append, delete, rename. Set to false to allow blind overwrites.
`MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS` Optional	Set to true to have write, edit and append list, under unresolved_links, the target of each link the call added that get_broken_links reports. Links the note already held are left out. Off by default, leaving those responses unchanged.
`MARKDOWN_VAULT_MCP_DISABLE_APPS_UI` Optional	Hide the MCP Apps UI tools (browse_vault, show_context) from the tool listing for clients that do not render MCP Apps panels.
`MARKDOWN_VAULT_MCP_INDEX_PATH` Optional	Path to the SQLite FTS5 index file; unset keeps the index in memory. Set it for persistence across restarts.
`MARKDOWN_VAULT_MCP_STATE_PATH` Optional	Path to the change-tracking state file. Defaults to INDEX_PATH plus .state.json (index.db.state.json beside index.db); without INDEX_PATH the state is kept in memory. Never written into the vault by default.
`MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH` Optional	Base path for the embeddings files. Defaults beside INDEX_PATH (index-db-embeddings.sqlite3 beside index.db, or index-db-embeddings.v2.json and the matrix it names with EMBEDDING_STORE=numpy; the first build copies in the vectors a release's sidecar there holds, then leaves it alone); without INDEX…
`MARKDOWN_VAULT_MCP_EMBEDDING_STORE` Optional	Where embeddings are stored. 'sqlite' (the default) keeps them in one SQLite database beside the index (index-db-embeddings.sqlite3), each change written durably on its own; 'numpy' keeps them in files there and rewrites them all on each save. Without INDEX_PATH or EMBEDDINGS_PATH both keep them in…
`MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH` Optional	How semantic search reads the embeddings. 'resident' holds them all in memory, the fastest; 'streamed' keeps none in memory and reads them from the store in batches for each search, slower as the vault grows. 'streamed' needs EMBEDDING_STORE=sqlite or postgres, and postgres is always streamed; vect…
`MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB` Optional	With EMBEDDING_STORE=sqlite and EMBEDDING_SEARCH=streamed, the embeddings one batch of a search may hold, in MiB (at least 1). It bounds the search's working memory, not the process's; postgres scores in the database and does not use it.
`MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN` Optional, secret	With EMBEDDING_STORE=postgres, the libpq connection string or URI of the database holding the embeddings. A secret: never logged or shown. The password may instead come from PGPASSWORD or a .pgpass file.
`MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA` Optional	With EMBEDDING_STORE=postgres, the schema this vault's embeddings live in: one schema per vault, created by the operator. The vault creates only its own tables there.
`MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE` Optional	With EMBEDDING_STORE=postgres, the most connections the store opens (at least 1).
`MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S` Optional	With EMBEDDING_STORE=postgres, the longest one query may run, in seconds (0 sets none; at most 2147483.647). The bulk write of a full rebuild is never limited.
`MARKDOWN_VAULT_MCP_INDEXED_FIELDS` Optional	Comma-separated frontmatter fields promoted to the tag index for structured filtering. Changing it cold-rebuilds the index once on next startup; SEARCHABLE_FIELDS inherits this value when unset.
`MARKDOWN_VAULT_MCP_REQUIRED_FIELDS` Optional	Comma-separated frontmatter fields required on every document; documents missing any are excluded from the index.
`MARKDOWN_VAULT_MCP_EXCLUDE` Optional	Comma-separated glob patterns excluded from scanning, e.g. .obsidian/,.trash/.
`MARKDOWN_VAULT_MCP_TITLE_FIELD` Optional	Frontmatter field used as the document title (falls back to title, the first H1, then the filename). Changing it cold-rebuilds the index once on next startup.
`MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS` Optional	Comma-separated frontmatter fields whose text values become keyword-searchable and enrich first-chunk embeddings. Inherits INDEXED_FIELDS when unset; the sentinel none means filterable but not searchable. Changing it cold-rebuilds the index and re-embeds once on next startup.
`MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER` Optional	Relative folder where note templates live (used by the create_from_template prompt).
`MARKDOWN_VAULT_MCP_PROMPTS_FOLDER` Optional	Directory of .md prompt files that extend or override built-in prompts; a relative path is resolved against SOURCE_DIR.
`MARKDOWN_VAULT_MCP_CONVENTIONS_FILE` Optional	Filename of the per-folder conventions files surfaced to clients at write time (bare .md filename without glob characters). Set to none to disable folder conventions.
`MARKDOWN_VAULT_MCP_OKF_MODE` Optional	OKF (Open Knowledge Format) read semantics. With auto (the default), read annotations switch on when the vault declares an OKF version in its root index.md. Use off to disable OKF semantics entirely, or on to force them for an undeclared vault. Annotations are read-only; write behavior is never aff…
`MARKDOWN_VAULT_MCP_OKF_WRITE` Optional	OKF (Open Knowledge Format) enforced write layer. When true on an OKF-active vault, the server stamps generated provenance on each write and clears any verified attestation when a note's content changes. It also keeps each written folder's log.md and index.md current, and exposes the okf_verify too…
`MARKDOWN_VAULT_MCP_OKF_VERIFY` Optional	How the okf_verify tool attributes a human review. This applies only when OKF_WRITE is on, which gates the tool. With elicit (the default), okf_verify asks the human to confirm the review through an MCP elicitation, then records the attestation only on an affirmative reply. It fails closed when the…
`MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS` Optional	Comma-separated token sub values that belong to applications, not people. A caller whose sub is listed is a service: its OKF writes stamp the tool actor instead of human:<sub>, and okf_verify records its review as local (elicit) or refuses it (trust-auth). Entries match the token's sub exactly. Use…
`MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS` Optional	Comma-separated allowed attachment extensions (e.g. pdf,png,jpg); case and a leading dot are ignored, so PDF and .pdf name the same type. Use * to allow every non-markdown file. Unset selects the built-in allowlist. A link whose target has a listed extension is not part of the link graph; changing…
`MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB` Optional	Maximum attachment size in MB returned by read / accepted by write; 0 disables the limit.
`MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES` Optional	Maximum bytes returned by a full-document read of a note; use `read(path, section=…)` for partial reads. 0 disables the limit.
`MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE` Optional	Mode used when a search call omits 'mode': auto, keyword, semantic, or hybrid. The default 'auto' picks hybrid when embeddings are configured and keyword when they are not. Pin 'keyword' to keep unqualified searches off the embedding provider (each hybrid or semantic search embeds the query, which…
`MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE` Optional	Maximum chunks returned per document in search results.
`MARKDOWN_VAULT_MCP_SNIPPET_WORDS` Optional	Width of the snippet window (words) in search results; 0 returns full chunk content.
`MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA` Optional	Down-weights longer chunks in ranking: score / (1 + alpha * log(chunk_count)).
`MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS` Optional	Word cap per chunk; the adaptive chunker splits at deeper heading levels, then paragraph/word boundaries, to respect it. Match it to the embedding model's context. A reindex applies a new value.
`MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS` Optional	Character cap enforced alongside MAX_CHUNK_WORDS to bound token-dense chunks. Unset derives min(1500, model context * 2.8). Set a positive value for an exact cap, or -1 to scale with the model's full context (can exhaust memory on long-context models). A reindex applies a new value.
`MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS` Optional	Words of overlap between adjacent budget-split fragments of the same heading section (0 disables). A reindex applies a new value.
`MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS` Optional	Folder-prefix score multipliers (`prefix:weight` pairs, comma-separated, weights > 0) applied to all search modes; the deepest matching prefix wins (sessions:0.5 demotes sessions/**).
`MARKDOWN_VAULT_MCP_FTS_WEIGHTS` Optional	Per-column BM25 weights (`column:weight` pairs, comma-separated, weights >= 0) for keyword ranking. Columns: path, title, folder, heading, content, summary.
`MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER` Optional	Embedding provider: openai, voyage, ollama, or fastembed; setting it turns on search by meaning. Unset auto-detects from the environment (never voyage), but only when EMBEDDINGS_PATH is set or EMBEDDING_STORE=postgres. Any OpenAI-compatible endpoint works with openai plus OPENAI_BASE_URL; see the e…
`MARKDOWN_VAULT_MCP_OLLAMA_MODEL` Optional	Ollama embedding model name.
`MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY` Optional	Force Ollama to embed on CPU only.
`MARKDOWN_VAULT_MCP_VOYAGE_MODEL` Optional	Voyage AI embedding model name.
`MARKDOWN_VAULT_MCP_OPENAI_BASE_URL` Optional	OpenAI-compatible API base URL for embeddings; the bare OPENAI_BASE_URL is honoured as a fallback.
`MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL` Optional	OpenAI-compatible embedding model name; the bare OPENAI_EMBEDDING_MODEL is honoured as a fallback.
`MARKDOWN_VAULT_MCP_FASTEMBED_MODEL` Optional	FastEmbed model name.
`MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR` Optional	FastEmbed model cache directory (in Docker, stored under /data/state/fastembed).
`MARKDOWN_VAULT_MCP_EMBED_CONTEXT` Optional	Enrich embedding input with the note title, chunk heading, and (first chunk) searchable-field values. Flipping it re-embeds the whole vault once on next startup.
`MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S` Optional	Per-request wall-clock budget in seconds for a single embedding HTTP call (OpenAI/Ollama). The local FastEmbed backend runs in-process with no network call and ignores this. CPU-only or large-model workloads may need 60-120 s; raise this if batches time out.
`MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE` Optional	Number of chunks sent per embedding request. Smaller batches shorten each request (useful under a tight timeout on slow models) at the cost of more round-trips.
`MARKDOWN_VAULT_MCP_GIT_TOKEN` Optional, secret	Token/password for HTTPS git auth; remotes must be HTTPS when set.
`MARKDOWN_VAULT_MCP_GIT_REPO_URL` Optional	HTTPS remote URL for managed git mode: the server clones into an empty SOURCE_DIR on startup (or validates an existing origin) and enables the pull loop, auto-commit, and deferred push.
`MARKDOWN_VAULT_MCP_GIT_USERNAME` Optional	Username for HTTPS git auth prompts (x-access-token for GitHub, oauth2 for GitLab, the account name for Bitbucket).
`MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S` Optional	Seconds between git fetch + fast-forward update attempts; 0 disables periodic pull.
`MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S` Optional	Seconds of write-idle time before pushing; 0 pushes only on shutdown.
`MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME` Optional	Git committer name for auto-commits, and the author name too unless an OIDC claim supplies one; set this in Docker where git config user.name is empty.
`MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL` Optional	Git committer email for auto-commits, and the author email too unless an OIDC claim supplies one.
`MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM` Optional	OIDC claim key used as the commit author name (e.g. name) when an OIDC token is present; the committer stays GIT_COMMIT_NAME. The claim is resolved when the tool call arrives and carried to the background commit, so it applies on every write. A configured claim the token does not carry is reported…
`MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM` Optional	OIDC claim key used as the commit author email (e.g. email) when an OIDC token is present; the committer stays GIT_COMMIT_EMAIL. Resolved and carried the same way as the name claim.
`MARKDOWN_VAULT_MCP_GIT_LFS` Optional	Run git lfs pull on startup to fetch LFS-tracked attachments; set to false for repos without LFS.
`MARKDOWN_VAULT_MCP_FILE_WATCHER` Optional	Watch the vault for external filesystem changes; auto-disabled when git pull is active or a webhook can deliver (HTTP/SSE transports only). Requires the file-watcher extra.
`MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S` Optional	Seconds of quiet after the last filesystem event before reindexing.
`MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR` Optional	Keep the non-recursive watch on the vault root; set false to register zero source-dir-rooted FSEvents streams (avoids repeated macOS access prompts on a home-rooted vault) at the cost of root-level files relying on scans.
`MARKDOWN_VAULT_MCP_BOOT_REINDEX` Optional	Reconcile offline changes at startup by reindexing once the initial build completes. Set false on a large vault to start without paying a full filesystem scan per server start; changes made while no server was running are then invisible until a reindex runs (the reindex tool, or 'markdown-vault-mcp…
`MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET` Optional, secret	Shared secret for the GitHub push-event webhook; when set, mounts POST /github-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events.
`MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN` Optional, secret	Signing token for the GitLab push-event webhook (GitLab 19.0+); when set, mounts POST /gitlab-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events. GitLab generates this value; copy the `whsec_` token it shows under Generate signing token rather than inventing one. D…
`MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN` Optional, secret	Secret token for the GitLab push-event webhook, GitLab's plain-text form and the only one below 19.0; also mounts POST /gitlab-webhook. It proves nothing about the body and cannot expire, so prefer the signing token where the GitLab version offers it. Setting both accepts either, which is how an ex…
`MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER` Optional	Summarization backend (only openai is recognised). Unset auto-detects: the backend activates when credentials or an explicit endpoint are present.
`MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY` Optional, secret	API key for the OpenAI-compatible summarize endpoint; the bare OPENAI_API_KEY is honoured as a fallback. Unset works for keyless local endpoints (Ollama).
`MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL` Optional	OpenAI-compatible endpoint base URL for the summarize tool; setting it enables the tool even without an API key. The bare OPENAI_BASE_URL routes traffic only when a key already enables the feature.
`MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL` Optional	Chat model id used for summaries.
`MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS` Optional	Upper bound on generated tokens per summarize call; on reasoning models this budget also covers internal reasoning tokens.
`MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES` Optional	Cap on the number of notes summarised in one call (subtree expansion truncates to this many).
`MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS` Optional	Aggregate cap on note characters sent to the model in one call; excess is truncated with a flag on the result.
`MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT` Optional	Per-request wall-clock budget in seconds for a single summarize backend call; keep it below the MCP client's request timeout so the server-side error wins the race.
`MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S` Optional	Link lifetime in seconds when the caller requests no explicit TTL.
`MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S` Optional	Ceiling in seconds a caller-requested link TTL is clamped to.
`MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S` Optional	Post-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it.
`MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S` Optional	Crashed-handler reclaim window in seconds for an in-flight reservation.
`MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES` Optional	Maximum size in bytes of a single upload.
`MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S` Optional	Seconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead.
`MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S` Optional	Seconds a background-job record (working or finished) is retained for polling before it expires from the store.
`MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT` Optional	Maximum live background jobs per calling subject; further promotions are rejected until older records expire.

Details

Package	`[email protected]` (PYPI, stdio)
Package	`ghcr.io/pvliesdonk/markdown-vault-mcp:v6.1.1` (OCI, streamable-http)
First published	8 Nov 2026
Last updated	8 Nov 2026
Registry name	`io.github.pvliesdonk/markdown-vault-mcp`

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use Markdown Vault MCP often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-pvliesdonk-markdown-vault-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-pvliesdonk-markdown-vault-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.

Connect Runs on your machine

Tools

Environment variables

Details

More files and documents servers See all