Who maintains Markdown Vault MCP?

Markdown Vault MCP is maintained by pvliesdonk, which publishes 7 MCP servers (52 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 25 versions of Markdown Vault MCP, most recently published on Aug 30, 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.

SERVER

Markdown Vault MCP

Rank #646

io.github.pvliesdonk/markdown-vault-mcp

Generic markdown vault MCP with hybrid search

25 versions

31 GitHub stars

by pvliesdonk (7 servers)View repository ↗

First listed

Mar 7, 2026

Last publish date

Aug 30, 2026

OVERVIEW

Markdown Vault MCP is a Model Context Protocol (MCP) server published by pvliesdonk. It ranks #646 of 115,460 servers tracked on MCP Toplist, and its repository has 31 GitHub stars. Markdown Vault MCP is listed across 3 registries — Official MCP, PulseMCP and Glama, with 25 tracked versions. It was first listed on Mar 7, 2026 and most recently updated on Aug 30, 2026.

STANDING

#646of 115,460 tracked serversTop 1%

Ranks ahead of 114,814 of 115,460 servers on MCP Toplist.

Recent momentum

+25GitHub stars since Apr 27 (+417%)

CONNECT

Use Markdown Vault MCP

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

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_INSTRUCTIONS_EXTRA=<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>" -e "MARKDOWN_VAULT_MCP_INSTRUCTIONS=<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>" -e "FASTMCP_LOG_LEVEL=<your FASTMCP_LOG_LEVEL>" -e "FASTMCP_ENABLE_RICH_LOGGING=<your FASTMCP_ENABLE_RICH_LOGGING>" -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_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_GITHUB_WEBHOOK_SECRET=<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>" -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_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_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 "PUID=<your PUID>" -e "PGID=<your PGID>" -e "FASTMCP_LOG_LEVEL=<your FASTMCP_LOG_LEVEL>" -e "FASTMCP_ENABLE_RICH_LOGGING=<your FASTMCP_ENABLE_RICH_LOGGING>" -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_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_GITHUB_WEBHOOK_SECRET=<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>" -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:v4.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_INSTRUCTIONS_EXTRA = "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>"
MARKDOWN_VAULT_MCP_INSTRUCTIONS = "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>"
FASTMCP_LOG_LEVEL = "<your FASTMCP_LOG_LEVEL>"
FASTMCP_ENABLE_RICH_LOGGING = "<your FASTMCP_ENABLE_RICH_LOGGING>"
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_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_GITHUB_WEBHOOK_SECRET = "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>"
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:v4.1.0", "--port", "8000"]

[mcp_servers.markdown-vault-mcp.env]
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_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>"
PUID = "<your PUID>"
PGID = "<your PGID>"
FASTMCP_LOG_LEVEL = "<your FASTMCP_LOG_LEVEL>"
FASTMCP_ENABLE_RICH_LOGGING = "<your FASTMCP_ENABLE_RICH_LOGGING>"
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_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_GITHUB_WEBHOOK_SECRET = "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>"
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_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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:v4.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "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_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>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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:v4.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "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_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>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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:v4.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "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_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>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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:v4.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "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_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>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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_INSTRUCTIONS_EXTRA": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<your MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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:v4.1.0",
        "--port",
        "8000"
      ],
      "env": {
        "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_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>",
        "PUID": "<your PUID>",
        "PGID": "<your PGID>",
        "FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<your FASTMCP_ENABLE_RICH_LOGGING>",
        "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_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_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "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.

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 115,460" /></a>

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

REGISTRIES

Listed on 2 registries (1 delisted)

Official MCP

PulseMCPDelisted · last seen Jun 4, 2026

Glama

ORGANIZATION

pvliesdonk

Organization

pvliesdonk

Servers in org

Versions across org

Other servers by pvliesdonk

View all pvliesdonk servers →

VERSIONS

Available versions (25)

Version	Published
4.1.0	Aug 30, 2026
4.0.0	Aug 25, 2026
3.0.4	Jun 27, 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

FAQ

Frequently asked questions

Who maintains Markdown Vault MCP?: Markdown Vault MCP is maintained by pvliesdonk, which publishes 7 MCP servers (52 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 25 versions of Markdown Vault MCP, most recently published on Aug 30, 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.

EXPLORE

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