SERVER

Markdown Vault MCP

Rank #645

io.github.pvliesdonk/markdown-vault-mcp

Generic markdown vault MCP with hybrid search

33 versions

34 GitHub stars

by pvliesdonk (7 servers)View repository ↗

First listed

Mar 7, 2026

Last publish date

Oct 7, 2026

PURPOSE

What you can do with Markdown Vault MCP

Markdown Vault MCP is a Model Context Protocol (MCP) server published by pvliesdonk. It ranks #645 of 144,396 active servers on MCP Toplist, and its repository has 34 GitHub stars. Markdown Vault MCP is listed across 3 registries — Official MCP, PulseMCP and Glama, with 33 tracked versions. It was first listed on Mar 7, 2026 and most recently updated on Oct 7, 2026.

Not verifiedMCP Toplist has not yet written a checked profile for this server, so the paragraph above is assembled from registry data only. The repository README is the authority on what it does.

CAPABILITIES AND LIMITATIONS

What Markdown Vault MCP can and cannot do

Not verifiedMCP Toplist has not catalogued this server's tools or limitations. The repository README lists them.

REQUIREMENTS

What you need before using Markdown Vault MCP

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Declared in the registry install config

MARKDOWN_VAULT_MCP_KV_STORE_URL · optional
MARKDOWN_VAULT_MCP_TOOLS_ALLOW · optional
MARKDOWN_VAULT_MCP_TOOLS_DENY · optional
MARKDOWN_VAULT_MCP_SERVER_NAME · optional
MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION · optional
MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA · optional
MARKDOWN_VAULT_MCP_INSTRUCTIONS · optional
MARKDOWN_VAULT_MCP_LOG_LEVEL · optional
MARKDOWN_VAULT_MCP_LOG_FORMAT · optional
OLLAMA_HOST · optional
OPENAI_API_KEY · optional
VOYAGE_API_KEY · optional
OPENAI_BASE_URL · optional
OPENAI_EMBEDDING_MODEL · optional
MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S · optional
MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S · optional
MARKDOWN_VAULT_MCP_SOURCE_DIR · optional
MARKDOWN_VAULT_MCP_READ_ONLY · optional
MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING · optional
MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS · optional
MARKDOWN_VAULT_MCP_DISABLE_APPS_UI · optional
MARKDOWN_VAULT_MCP_INDEX_PATH · optional
MARKDOWN_VAULT_MCP_STATE_PATH · optional
MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH · optional
MARKDOWN_VAULT_MCP_INDEXED_FIELDS · optional
MARKDOWN_VAULT_MCP_REQUIRED_FIELDS · optional
MARKDOWN_VAULT_MCP_EXCLUDE · optional
MARKDOWN_VAULT_MCP_TITLE_FIELD · optional
MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS · optional
MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER · optional
MARKDOWN_VAULT_MCP_PROMPTS_FOLDER · optional
MARKDOWN_VAULT_MCP_CONVENTIONS_FILE · optional
MARKDOWN_VAULT_MCP_OKF_MODE · optional
MARKDOWN_VAULT_MCP_OKF_WRITE · optional
MARKDOWN_VAULT_MCP_OKF_VERIFY · optional
MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS · optional
MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB · optional
MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES · optional
MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE · optional
MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE · optional
MARKDOWN_VAULT_MCP_SNIPPET_WORDS · optional
MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA · optional
MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS · optional
MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS · optional
MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS · optional
MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS · optional
MARKDOWN_VAULT_MCP_FTS_WEIGHTS · optional
MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER · optional
MARKDOWN_VAULT_MCP_OLLAMA_MODEL · optional
MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY · optional
MARKDOWN_VAULT_MCP_VOYAGE_MODEL · optional
MARKDOWN_VAULT_MCP_OPENAI_BASE_URL · optional
MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL · optional
MARKDOWN_VAULT_MCP_FASTEMBED_MODEL · optional
MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR · optional
MARKDOWN_VAULT_MCP_EMBED_CONTEXT · optional
MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S · optional
MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE · optional
MARKDOWN_VAULT_MCP_GIT_TOKEN · optional
MARKDOWN_VAULT_MCP_GIT_REPO_URL · optional
MARKDOWN_VAULT_MCP_GIT_USERNAME · optional
MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S · optional
MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S · optional
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME · optional
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL · optional
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM · optional
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM · optional
MARKDOWN_VAULT_MCP_GIT_LFS · optional
MARKDOWN_VAULT_MCP_FILE_WATCHER · optional
MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S · optional
MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR · optional
MARKDOWN_VAULT_MCP_BOOT_REINDEX · optional
MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET · optional
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN · optional
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS · optional
MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT · optional
MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S · optional
MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S · optional
MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S · optional
MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S · optional
MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES · optional
MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S · optional
MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S · optional
MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT · optional
MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S · optional
MARKDOWN_VAULT_MCP_BASE_URL · optional
MARKDOWN_VAULT_MCP_BEARER_TOKEN · optional
MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL · optional
MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID · optional
MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET · optional
MARKDOWN_VAULT_MCP_OIDC_AUDIENCE · optional
MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES · optional
MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES · optional
MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY · optional
MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN · optional
MARKDOWN_VAULT_MCP_APP_DOMAIN · optional
MARKDOWN_VAULT_MCP_AUTH_MODE · optional
MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE · optional
MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT · optional
MARKDOWN_VAULT_MCP_HTTP_PATH · optional
MARKDOWN_VAULT_MCP_HEALTH_DETAIL · optional
PUID · optional
PGID · optional

INSTALLATION AND FIRST TASK

Connect Markdown Vault MCP and confirm it works

Python package (PyPI)

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

Replace each placeholder with your own value before saving.

Docker image

claude mcp add markdown-vault-mcp -e "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S=<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>" -e "MARKDOWN_VAULT_MCP_BASE_URL=<your MARKDOWN_VAULT_MCP_BASE_URL>" -e "MARKDOWN_VAULT_MCP_BEARER_TOKEN=<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>" -e "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL=<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>" -e "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID=<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>" -e "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET=<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>" -e "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE=<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>" -e "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES=<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>" -e "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES=<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>" -e "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY=<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>" -e "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN=<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>" -e "MARKDOWN_VAULT_MCP_KV_STORE_URL=<your MARKDOWN_VAULT_MCP_KV_STORE_URL>" -e "MARKDOWN_VAULT_MCP_APP_DOMAIN=<your MARKDOWN_VAULT_MCP_APP_DOMAIN>" -e "MARKDOWN_VAULT_MCP_TOOLS_ALLOW=<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>" -e "MARKDOWN_VAULT_MCP_TOOLS_DENY=<your MARKDOWN_VAULT_MCP_TOOLS_DENY>" -e "MARKDOWN_VAULT_MCP_AUTH_MODE=<your MARKDOWN_VAULT_MCP_AUTH_MODE>" -e "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE=<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>" -e "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT=<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>" -e "MARKDOWN_VAULT_MCP_SERVER_NAME=<your MARKDOWN_VAULT_MCP_SERVER_NAME>" -e "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION=<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>" -e "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA=<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>" -e "MARKDOWN_VAULT_MCP_INSTRUCTIONS=<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>" -e "MARKDOWN_VAULT_MCP_HTTP_PATH=<your MARKDOWN_VAULT_MCP_HTTP_PATH>" -e "MARKDOWN_VAULT_MCP_HEALTH_DETAIL=<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>" -e "PUID=<your PUID>" -e "PGID=<your PGID>" -e "MARKDOWN_VAULT_MCP_LOG_LEVEL=<your MARKDOWN_VAULT_MCP_LOG_LEVEL>" -e "MARKDOWN_VAULT_MCP_LOG_FORMAT=<your MARKDOWN_VAULT_MCP_LOG_FORMAT>" -e "OLLAMA_HOST=<your OLLAMA_HOST>" -e "OPENAI_API_KEY=<your OPENAI_API_KEY>" -e "VOYAGE_API_KEY=<your VOYAGE_API_KEY>" -e "OPENAI_BASE_URL=<your OPENAI_BASE_URL>" -e "OPENAI_EMBEDDING_MODEL=<your OPENAI_EMBEDDING_MODEL>" -e "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>" -e "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>" -e "MARKDOWN_VAULT_MCP_SOURCE_DIR=<your MARKDOWN_VAULT_MCP_SOURCE_DIR>" -e "MARKDOWN_VAULT_MCP_READ_ONLY=<your MARKDOWN_VAULT_MCP_READ_ONLY>" -e "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>" -e "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>" -e "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>" -e "MARKDOWN_VAULT_MCP_INDEX_PATH=<your MARKDOWN_VAULT_MCP_INDEX_PATH>" -e "MARKDOWN_VAULT_MCP_STATE_PATH=<your MARKDOWN_VAULT_MCP_STATE_PATH>" -e "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH=<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>" -e "MARKDOWN_VAULT_MCP_INDEXED_FIELDS=<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>" -e "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS=<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>" -e "MARKDOWN_VAULT_MCP_EXCLUDE=<your MARKDOWN_VAULT_MCP_EXCLUDE>" -e "MARKDOWN_VAULT_MCP_TITLE_FIELD=<your MARKDOWN_VAULT_MCP_TITLE_FIELD>" -e "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS=<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>" -e "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>" -e "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER=<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>" -e "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>" -e "MARKDOWN_VAULT_MCP_OKF_MODE=<your MARKDOWN_VAULT_MCP_OKF_MODE>" -e "MARKDOWN_VAULT_MCP_OKF_WRITE=<your MARKDOWN_VAULT_MCP_OKF_WRITE>" -e "MARKDOWN_VAULT_MCP_OKF_VERIFY=<your MARKDOWN_VAULT_MCP_OKF_VERIFY>" -e "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS=<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>" -e "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>" -e "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>" -e "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>" -e "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>" -e "MARKDOWN_VAULT_MCP_SNIPPET_WORDS=<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>" -e "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>" -e "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>" -e "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS=<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>" -e "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>" -e "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS=<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>" -e "MARKDOWN_VAULT_MCP_FTS_WEIGHTS=<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>" -e "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>" -e "MARKDOWN_VAULT_MCP_OLLAMA_MODEL=<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>" -e "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>" -e "MARKDOWN_VAULT_MCP_VOYAGE_MODEL=<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>" -e "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>" -e "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>" -e "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>" -e "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR=<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>" -e "MARKDOWN_VAULT_MCP_EMBED_CONTEXT=<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>" -e "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>" -e "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>" -e "MARKDOWN_VAULT_MCP_GIT_TOKEN=<your MARKDOWN_VAULT_MCP_GIT_TOKEN>" -e "MARKDOWN_VAULT_MCP_GIT_REPO_URL=<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>" -e "MARKDOWN_VAULT_MCP_GIT_USERNAME=<your MARKDOWN_VAULT_MCP_GIT_USERNAME>" -e "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>" -e "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM=<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>" -e "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM=<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>" -e "MARKDOWN_VAULT_MCP_GIT_LFS=<your MARKDOWN_VAULT_MCP_GIT_LFS>" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER=<your MARKDOWN_VAULT_MCP_FILE_WATCHER>" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>" -e "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>" -e "MARKDOWN_VAULT_MCP_BOOT_REINDEX=<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>" -e "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET=<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>" -e "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN=<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>" -e "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN=<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER=<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY=<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL=<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>" -e "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>" -e "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>" -e "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>" -e "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>" -e "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>" -e "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>" -e "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>" -e "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>" -e "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>" -- docker run -i --rm ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0 --port 8000

Replace each placeholder with your own value before saving.

Python package (PyPI)

[mcp_servers.markdown-vault-mcp]
command = "uvx"
args = ["markdown-vault-mcp"]

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

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Docker image

[mcp_servers.markdown-vault-mcp]
command = "docker"
args = ["run", "-i", "--rm", "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0", "--port", "8000"]

[mcp_servers.markdown-vault-mcp.env]
MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S = "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>"
MARKDOWN_VAULT_MCP_BASE_URL = "<your MARKDOWN_VAULT_MCP_BASE_URL>"
MARKDOWN_VAULT_MCP_BEARER_TOKEN = "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>"
MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL = "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>"
MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID = "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>"
MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET = "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>"
MARKDOWN_VAULT_MCP_OIDC_AUDIENCE = "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>"
MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES = "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>"
MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES = "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>"
MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY = "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>"
MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN = "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>"
MARKDOWN_VAULT_MCP_KV_STORE_URL = "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>"
MARKDOWN_VAULT_MCP_APP_DOMAIN = "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>"
MARKDOWN_VAULT_MCP_TOOLS_ALLOW = "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>"
MARKDOWN_VAULT_MCP_TOOLS_DENY = "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>"
MARKDOWN_VAULT_MCP_AUTH_MODE = "<your MARKDOWN_VAULT_MCP_AUTH_MODE>"
MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE = "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>"
MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT = "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>"
MARKDOWN_VAULT_MCP_SERVER_NAME = "<your MARKDOWN_VAULT_MCP_SERVER_NAME>"
MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION = "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>"
MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA = "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>"
MARKDOWN_VAULT_MCP_INSTRUCTIONS = "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>"
MARKDOWN_VAULT_MCP_HTTP_PATH = "<your MARKDOWN_VAULT_MCP_HTTP_PATH>"
MARKDOWN_VAULT_MCP_HEALTH_DETAIL = "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>"
PUID = "<your PUID>"
PGID = "<your PGID>"
MARKDOWN_VAULT_MCP_LOG_LEVEL = "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>"
MARKDOWN_VAULT_MCP_LOG_FORMAT = "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>"
OLLAMA_HOST = "<your OLLAMA_HOST>"
OPENAI_API_KEY = "<your OPENAI_API_KEY>"
VOYAGE_API_KEY = "<your VOYAGE_API_KEY>"
OPENAI_BASE_URL = "<your OPENAI_BASE_URL>"
OPENAI_EMBEDDING_MODEL = "<your OPENAI_EMBEDDING_MODEL>"
MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S = "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>"
MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S = "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>"
MARKDOWN_VAULT_MCP_SOURCE_DIR = "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>"
MARKDOWN_VAULT_MCP_READ_ONLY = "<your MARKDOWN_VAULT_MCP_READ_ONLY>"
MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING = "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>"
MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS = "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>"
MARKDOWN_VAULT_MCP_DISABLE_APPS_UI = "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>"
MARKDOWN_VAULT_MCP_INDEX_PATH = "<your MARKDOWN_VAULT_MCP_INDEX_PATH>"
MARKDOWN_VAULT_MCP_STATE_PATH = "<your MARKDOWN_VAULT_MCP_STATE_PATH>"
MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH = "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>"
MARKDOWN_VAULT_MCP_INDEXED_FIELDS = "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>"
MARKDOWN_VAULT_MCP_REQUIRED_FIELDS = "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>"
MARKDOWN_VAULT_MCP_EXCLUDE = "<your MARKDOWN_VAULT_MCP_EXCLUDE>"
MARKDOWN_VAULT_MCP_TITLE_FIELD = "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>"
MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS = "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>"
MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER = "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>"
MARKDOWN_VAULT_MCP_PROMPTS_FOLDER = "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>"
MARKDOWN_VAULT_MCP_CONVENTIONS_FILE = "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>"
MARKDOWN_VAULT_MCP_OKF_MODE = "<your MARKDOWN_VAULT_MCP_OKF_MODE>"
MARKDOWN_VAULT_MCP_OKF_WRITE = "<your MARKDOWN_VAULT_MCP_OKF_WRITE>"
MARKDOWN_VAULT_MCP_OKF_VERIFY = "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>"
MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS = "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>"
MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB = "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>"
MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES = "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>"
MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE = "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>"
MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE = "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>"
MARKDOWN_VAULT_MCP_SNIPPET_WORDS = "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>"
MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA = "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>"
MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS = "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>"
MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS = "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>"
MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS = "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>"
MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS = "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>"
MARKDOWN_VAULT_MCP_FTS_WEIGHTS = "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>"
MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER = "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>"
MARKDOWN_VAULT_MCP_OLLAMA_MODEL = "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>"
MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY = "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>"
MARKDOWN_VAULT_MCP_VOYAGE_MODEL = "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>"
MARKDOWN_VAULT_MCP_OPENAI_BASE_URL = "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>"
MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL = "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>"
MARKDOWN_VAULT_MCP_FASTEMBED_MODEL = "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>"
MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR = "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>"
MARKDOWN_VAULT_MCP_EMBED_CONTEXT = "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>"
MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S = "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>"
MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE = "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>"
MARKDOWN_VAULT_MCP_GIT_TOKEN = "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>"
MARKDOWN_VAULT_MCP_GIT_REPO_URL = "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>"
MARKDOWN_VAULT_MCP_GIT_USERNAME = "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>"
MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S = "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>"
MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S = "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>"
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME = "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>"
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL = "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>"
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM = "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>"
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM = "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>"
MARKDOWN_VAULT_MCP_GIT_LFS = "<your MARKDOWN_VAULT_MCP_GIT_LFS>"
MARKDOWN_VAULT_MCP_FILE_WATCHER = "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>"
MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S = "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>"
MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR = "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>"
MARKDOWN_VAULT_MCP_BOOT_REINDEX = "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>"
MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET = "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>"
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN = "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>"
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN = "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>"
MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>"
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>"
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>"
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>"
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>"
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>"
MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT = "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>"
MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S = "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>"
MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S = "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>"
MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S = "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>"
MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S = "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>"
MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES = "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>"
MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S = "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>"
MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S = "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>"
MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT = "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S": "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>",
        "MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE": "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>",
        "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT": "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_HTTP_PATH": "<your MARKDOWN_VAULT_MCP_HTTP_PATH>",
        "MARKDOWN_VAULT_MCP_HEALTH_DETAIL": "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<your OLLAMA_HOST>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<your MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<your MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<your MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S": "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>",
        "MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE": "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>",
        "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT": "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_HTTP_PATH": "<your MARKDOWN_VAULT_MCP_HTTP_PATH>",
        "MARKDOWN_VAULT_MCP_HEALTH_DETAIL": "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<your OLLAMA_HOST>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<your MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<your MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<your MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Docker image

{
  "servers": {
    "markdown-vault-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S": "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>",
        "MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE": "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>",
        "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT": "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_HTTP_PATH": "<your MARKDOWN_VAULT_MCP_HTTP_PATH>",
        "MARKDOWN_VAULT_MCP_HEALTH_DETAIL": "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<your OLLAMA_HOST>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<your MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<your MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<your MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S": "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>",
        "MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE": "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>",
        "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT": "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_HTTP_PATH": "<your MARKDOWN_VAULT_MCP_HTTP_PATH>",
        "MARKDOWN_VAULT_MCP_HEALTH_DETAIL": "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<your OLLAMA_HOST>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<your MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<your MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<your MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Python package (PyPI)

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

Replace each placeholder with your own value before saving.

Docker image

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S": "<your MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S>",
        "MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "<your MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID>",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "<your MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "<your MARKDOWN_VAULT_MCP_OIDC_AUDIENCE>",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES": "<your MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES>",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<your MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<your MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
        "MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE": "<your MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE>",
        "MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT": "<your MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<your MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "MARKDOWN_VAULT_MCP_HTTP_PATH": "<your MARKDOWN_VAULT_MCP_HTTP_PATH>",
        "MARKDOWN_VAULT_MCP_HEALTH_DETAIL": "<your MARKDOWN_VAULT_MCP_HEALTH_DETAIL>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "MARKDOWN_VAULT_MCP_LOG_FORMAT": "<your MARKDOWN_VAULT_MCP_LOG_FORMAT>",
        "OLLAMA_HOST": "<your OLLAMA_HOST>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<your MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "<your MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<your MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<your MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<your MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<your MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<your MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<your MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<your MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<your MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<your MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<your MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<your MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<your MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<your MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<your MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<your MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<your MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<your MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<your MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<your MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<your MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<your MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<your MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<your MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<your MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<your MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<your MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<your MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<your MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<your MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<your MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<your MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<your MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "<your MARKDOWN_VAULT_MCP_BOOT_REINDEX>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<your MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<your MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<your MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<your MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<your MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

First successful task

After adding the config, ask your client to list this server's tools. A tool list confirms the connection; an empty list or an error means the server did not start or needs credentials.

ALTERNATIVES

When to choose another server

Other servers by pvliesdonk

View all pvliesdonk servers →

No task-specific alternatives are catalogued for Markdown Vault MCPyet; the list above is its publisher's other servers.

MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed: Mar 7, 2026
Latest version published: Oct 7, 2026
Version history: 33 versions tracked (below)
Requirements evidence: Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
Profile checked: Not yet — purpose, capabilities and requirements above come from registry data only
Ranking data as of: Oct 16, 2026

Registry sightings

Official MCP ↗listed since Apr 25, 2026 · still listed
PulseMCP ↗listed since Jun 4, 2026 · still listed
Glama ↗listed since Jun 15, 2026 · still listed

Do you maintain Markdown Vault MCP? to correct or enrich this profile.

VERSIONS

Available versions (33)

Version	Published
5.1.0	Oct 7, 2026
5.0.0	Sep 27, 2026
4.2.0	Sep 13, 2026
4.1.0	Aug 30, 2026
4.0.0	Aug 25, 2026
3.1.0	Jul 8, 2026
3.0.4	Jun 27, 2026
3.0.3	Jun 26, 2026
3.0.2	Jun 25, 2026
3.0.1	Jun 22, 2026
3.0.0	Jun 17, 2026
1.27.1	Apr 23, 2026
1.27.0	Apr 21, 2026
1.25.0	Apr 20, 2026
1.23.1	Apr 20, 2026
1.23.0	Apr 19, 2026
1.22.1	Apr 17, 2026
1.22.0	Apr 16, 2026
1.21.0	Apr 10, 2026
1.20.1	Apr 10, 2026
1.20.0	Apr 8, 2026
1.19.1	Apr 4, 2026
1.19.0	Apr 4, 2026
1.18.1	Apr 2, 2026
1.18.0	Mar 31, 2026
1.17.0	Mar 24, 2026
1.16.0	Mar 23, 2026
1.15.0	Mar 21, 2026
1.14.0	Mar 19, 2026
1.13.4	Mar 19, 2026
1.13.3	Mar 19, 2026
1.13.1	Mar 18, 2026
0.1.0	Nov 25, 2024

STANDING

#645of 144,396 active serversTop 0.5%

Ranks ahead of 143,751 of 144,396 servers on MCP Toplist.

Recent momentum

+28GitHub stars since Apr 27 (+467%)

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.pvliesdonk%2Fmarkdown-vault-mcp.svg)](https://mcptoplist.com/server/io.github.pvliesdonk%2Fmarkdown-vault-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.pvliesdonk%2Fmarkdown-vault-mcp"><img src="https://mcptoplist.com/badge/io.github.pvliesdonk%2Fmarkdown-vault-mcp.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains Markdown Vault MCP?: Markdown Vault MCP is maintained by pvliesdonk, which publishes 7 MCP servers (63 total versions) tracked on MCP Toplist.
Is Markdown Vault MCP listed on the Official MCP Registry?: Yes — Markdown Vault MCP is listed on the Official MCP Registry, alongside PulseMCP and Glama.
How many versions does Markdown Vault MCP have?: MCP Toplist tracks 33 versions of Markdown Vault MCP, most recently published on Oct 7, 2026.
Where can I find the source code for Markdown Vault MCP?: The source code for Markdown Vault MCP is hosted at github.com/pvliesdonk/markdown-vault-mcp.

Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers