Markdown Vault MCP

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

• Connection: Runs on your computer
• Transport: stdio, Streamable HTTP
• Category: Docs, sheets & office work
• You need to fill in: OPENAI_API_KEY, VOYAGE_API_KEY, MARKDOWN_VAULT_MCP_CLIENT_TOKEN, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN, MARKDOWN_VAULT_MCP_GIT_TOKEN, MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY

Install

Pick the AI app you use, then copy the settings.

You need

• PyPIPython’s uv installed (for the uvx command)

Which app do you use?

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

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

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

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

Your choice stays on this device in a cookie; no account needed.

Values you fill in

• MARKDOWN_VAULT_MCP_KV_STORE_URL env
  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 `…
• MARKDOWN_VAULT_MCP_TOOLS_ALLOW env
  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_…
• MARKDOWN_VAULT_MCP_TOOLS_DENY env
  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 effe…
• MARKDOWN_VAULT_MCP_SERVER_NAME env
  Rename this server instance; defaults to the project name.
• MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION env
  Concise routing context that distinguishes this deployment's material or responsibility.
• MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA env
  Deployment-specific behavioral policy added to the generated MCP instructions.
• MARKDOWN_VAULT_MCP_INSTRUCTIONS env
  Legacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
• MARKDOWN_VAULT_MCP_LOG_LEVEL env
  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 maj…
• MARKDOWN_VAULT_MCP_LOG_FORMAT env
  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…
• OLLAMA_HOST env
  Ollama server URL for the ollama embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the Ollama ecosystem convention.
• OPENAI_API_KEY secret env
  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), match…
• VOYAGE_API_KEY secret env
  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…
• OPENAI_BASE_URL env
  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 env
  Bare fallback for MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL.
• MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S env
  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…
• MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S env
  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_stal…
• MARKDOWN_VAULT_MCP_SERVER_URL env
  Hosted MCP endpoint for CLI reads. The explicit server option overrides it. Local mode bypasses it.
• MARKDOWN_VAULT_MCP_CLIENT_CONFIG env
  Client TOML profile path; defaults to XDG_CONFIG_HOME/markdown-vault-mcp/client.toml.
• MARKDOWN_VAULT_MCP_CLIENT_TOKEN secret env
  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 env
  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 cl…
• MARKDOWN_VAULT_MCP_READ_ONLY env
  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 env
  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,…
• MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS env
  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…
• MARKDOWN_VAULT_MCP_DISABLE_APPS_UI env
  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 env
  Path to the SQLite FTS5 index file; unset keeps the index in memory. Set it for persistence across restarts.
• MARKDOWN_VAULT_MCP_STATE_PATH env
  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…
• MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH env
  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 fir…
• MARKDOWN_VAULT_MCP_EMBEDDING_STORE env
  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 fil…
• MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH env
  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 vau…
• MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB env
  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 score…
• MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN secret env
  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 f…
• MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMA env
  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 env
  With EMBEDDING_STORE=postgres, the most connections the store opens (at least 1).
• MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S env
  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 env
  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 env
  Comma-separated frontmatter fields required on every document; documents missing any are excluded from the index.
• MARKDOWN_VAULT_MCP_EXCLUDE env
  Comma-separated glob patterns excluded from scanning, e.g. .obsidian/**,.trash/**.
• MARKDOWN_VAULT_MCP_TITLE_FIELD env
  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 env
  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 search…
• MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER env
  Relative folder where note templates live (used by the create_from_template prompt).
• MARKDOWN_VAULT_MCP_PROMPTS_FOLDER env
  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 env
  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 env
  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,…
• MARKDOWN_VAULT_MCP_OKF_WRITE env
  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 chan…
• MARKDOWN_VAULT_MCP_OKF_VERIFY env
  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…
• MARKDOWN_VAULT_MCP_SERVICE_SUBJECTS env
  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: , and okf_verify records its…
• MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS env
  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 bui…
• MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB env
  Maximum attachment size in MB returned by read / accepted by write; 0 disables the limit.
• MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES env
  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 env
  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 unqu…
• MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE env
  Maximum chunks returned per document in search results.
• MARKDOWN_VAULT_MCP_SNIPPET_WORDS env
  Width of the snippet window (words) in search results; 0 returns full chunk content.
• MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA env
  Down-weights longer chunks in ranking: score / (1 + alpha * log(chunk_count)).
• MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS env
  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 env
  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…
• MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS env
  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 env
  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 env
  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 env
  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 EMBEDD…
• MARKDOWN_VAULT_MCP_OLLAMA_MODEL env
  Ollama embedding model name.
• MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY env
  Force Ollama to embed on CPU only.
• MARKDOWN_VAULT_MCP_VOYAGE_MODEL env
  Voyage AI embedding model name.
• MARKDOWN_VAULT_MCP_OPENAI_BASE_URL env
  OpenAI-compatible API base URL for embeddings; the bare OPENAI_BASE_URL is honoured as a fallback.
• MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL env
  OpenAI-compatible embedding model name; the bare OPENAI_EMBEDDING_MODEL is honoured as a fallback.
• MARKDOWN_VAULT_MCP_FASTEMBED_MODEL env
  FastEmbed model name.
• MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR env
  FastEmbed model cache directory (in Docker, stored under /data/state/fastembed).
• MARKDOWN_VAULT_MCP_EMBED_CONTEXT env
  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 env
  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 w…
• MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE env
  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 secret env
  Token/password for HTTPS git auth; remotes must be HTTPS when set.
• MARKDOWN_VAULT_MCP_GIT_REPO_URL env
  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 env
  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 env
  Seconds between git fetch + fast-forward update attempts; 0 disables periodic pull.
• MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S env
  Seconds of write-idle time before pushing; 0 pushes only on shutdown.
• MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME env
  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 env
  Git committer email for auto-commits, and the author email too unless an OIDC claim supplies one.
• MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM env
  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 backg…
• MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM env
  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 env
  Run git lfs pull on startup to fetch LFS-tracked attachments; set to false for repos without LFS.
• MARKDOWN_VAULT_MCP_FILE_WATCHER env
  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 env
  Seconds of quiet after the last filesystem event before reindexing.
• MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR env
  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 f…
• MARKDOWN_VAULT_MCP_BOOT_REINDEX env
  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…
• MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET secret env
  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 secret env
  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 th…
• MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN secret env
  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 t…
• MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER env
  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 secret env
  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 env
  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 env
  Chat model id used for summaries.
• MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS env
  Upper bound on generated tokens per summarize call; on reasoning models this budget also covers internal reasoning tokens.
• MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES env
  Cap on the number of notes summarised in one call (subtree expansion truncates to this many).
• MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS env
  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 env
  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 env
  Link lifetime in seconds when the caller requests no explicit TTL.
• MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S env
  Ceiling in seconds a caller-requested link TTL is clamped to.
• MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S env
  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 env
  Crashed-handler reclaim window in seconds for an in-flight reservation.
• MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES env
  Maximum size in bytes of a single upload.
• MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S env
  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 env
  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 env
  Maximum live background jobs per calling subject; further promotions are rejected until older records expire.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

• ✓ Pass

  Maker matches the repo

  The registry name was verified with the GitHub account pvliesdonk, which owns the repo

• … Not checked yet

  Still maintained

  We have not read this repo from GitHub yet

• … Not checked yet

  Has a licence

  We have not read this repo from GitHub yet

• – Not applicable

  Endpoint responds

  This one runs on your computer; there is no internet endpoint

• – Not applicable

  Sign-in with OAuth

  Runs on your computer and uses local settings instead

• … Not checked yet

  No hidden instructions in tool descriptions

  Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Docs, sheets & office worki

• More stars than 0% of the other 3543 servers in this category
• Published to the registry more recently than 84% of the other 3543 servers in this category
• Basic checks equal to or better than 100% of the other 3543 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

README from the maker

/plugin marketplace add pvliesdonk/claude-plugins

uv tool install "markdown-vault-mcp"

docker run --rm -p 8000:8000 --env-file .env ghcr.io/pvliesdonk/markdown-vault-mcp:latest

uv tool install "markdown-vault-mcp[all]"