Markdown Vault MCP
● Activeio.github.pvliesdonk/markdown-vault-mcp
Generic markdown vault MCP with hybrid search
Connect this server
One click to install, or copy the config below. Suits: Claude Desktop · Cursor.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "uvx",
"args": [
"markdown-vault-mcp"
],
"env": {
"MARKDOWN_VAULT_MCP_KV_STORE_URL": "file:///data/state",
"MARKDOWN_VAULT_MCP_LOG_LEVEL": "INFO",
"OLLAMA_HOST": "http://localhost:11434",
"OPENAI_API_KEY": "<your OPENAI_API_KEY>",
"VOYAGE_API_KEY": "<your VOYAGE_API_KEY>",
"MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "60",
"MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "60",
"MARKDOWN_VAULT_MCP_CLIENT_TOKEN": "<your MARKDOWN_VAULT_MCP_CLIENT_TOKEN>",
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "/data/vault",
"MARKDOWN_VAULT_MCP_READ_ONLY": "false",
"MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "true",
"MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "false",
"MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "false",
"MARKDOWN_VAULT_MCP_EMBEDDING_STORE": "sqlite",
"MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB": "1",
"MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN": "<your MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>",
"MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE": "4",
"MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S": "30.0",
"MARKDOWN_VAULT_MCP_TITLE_FIELD": "title",
"MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "_templates",
"MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "_conventions.md",
"MARKDOWN_VAULT_MCP_OKF_MODE": "auto",
"MARKDOWN_VAULT_MCP_OKF_WRITE": "false",
"MARKDOWN_VAULT_MCP_OKF_VERIFY": "elicit",
"MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "1.0",
"MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "262144",
"MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "auto",
"MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "2",
"MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "200",
"MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "0.25",
"MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "400",
"MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "40",
"MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "nomic-embed-text",
"MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "false",
"MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "voyage-4",
"MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "https://api.openai.com/v1",
"MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "text-embedding-3-small",
"MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "BAAI/bge-small-en-v1.5",
"MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "false",
"MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "30.0",
"MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "4",
"MARKDOWN_VAULT_MCP_GIT_TOKEN": "<your MARKDOWN_VAULT_MCP_GIT_TOKEN>",
"MARKDOWN_VAULT_MCP_GIT_USERNAME": "x-access-token",
"MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "600",
"MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "30.0",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "noreply@markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_LFS": "true",
"MARKDOWN_VAULT_MCP_FILE_WATCHER": "true",
"MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "2.0",
"MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "true",
"MARKDOWN_VAULT_MCP_BOOT_REINDEX": "true",
"MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
"MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
"MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
"MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
"MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "gpt-5-mini",
"MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "8192",
"MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "50",
"MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "200000",
"MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "120.0",
"MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "3600.0",
"MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "86400.0",
"MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "60.0",
"MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "60.0",
"MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "104857600",
"MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "25.0",
"MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "3600.0",
"MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "256"
}
}
}
}claude mcp add --env MARKDOWN_VAULT_MCP_KV_STORE_URL=file:///data/state --env MARKDOWN_VAULT_MCP_LOG_LEVEL=INFO --env OLLAMA_HOST=http://localhost:11434 --env OPENAI_API_KEY='<your OPENAI_API_KEY>' --env VOYAGE_API_KEY='<your VOYAGE_API_KEY>' --env MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=60 --env MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=60 --env MARKDOWN_VAULT_MCP_CLIENT_TOKEN='<your MARKDOWN_VAULT_MCP_CLIENT_TOKEN>' --env MARKDOWN_VAULT_MCP_SOURCE_DIR=/data/vault --env MARKDOWN_VAULT_MCP_READ_ONLY=false --env MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=true --env MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=false --env MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=false --env MARKDOWN_VAULT_MCP_EMBEDDING_STORE=sqlite --env MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB=1 --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN='<your MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>' --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE=4 --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S=30.0 --env MARKDOWN_VAULT_MCP_TITLE_FIELD=title --env MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=_templates --env MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=_conventions.md --env MARKDOWN_VAULT_MCP_OKF_MODE=auto --env MARKDOWN_VAULT_MCP_OKF_WRITE=false --env MARKDOWN_VAULT_MCP_OKF_VERIFY=elicit --env MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=1.0 --env MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=262144 --env MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=auto --env MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=2 --env MARKDOWN_VAULT_MCP_SNIPPET_WORDS=200 --env MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=0.25 --env MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=400 --env MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=40 --env MARKDOWN_VAULT_MCP_OLLAMA_MODEL=nomic-embed-text --env MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=false --env MARKDOWN_VAULT_MCP_VOYAGE_MODEL=voyage-4 --env MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=https://api.openai.com/v1 --env MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=text-embedding-3-small --env MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=BAAI/bge-small-en-v1.5 --env MARKDOWN_VAULT_MCP_EMBED_CONTEXT=false --env MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=30.0 --env MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=4 --env MARKDOWN_VAULT_MCP_GIT_TOKEN='<your MARKDOWN_VAULT_MCP_GIT_TOKEN>' --env MARKDOWN_VAULT_MCP_GIT_USERNAME=x-access-token --env MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=600 --env MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=30.0 --env MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=markdown-vault-mcp --env MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=noreply@markdown-vault-mcp --env MARKDOWN_VAULT_MCP_GIT_LFS=true --env MARKDOWN_VAULT_MCP_FILE_WATCHER=true --env MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=2.0 --env MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=true --env MARKDOWN_VAULT_MCP_BOOT_REINDEX=true --env MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET='<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN='<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN='<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY='<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=gpt-5-mini --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=8192 --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=50 --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=200000 --env MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=120.0 --env MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=3600.0 --env MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=86400.0 --env MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=60.0 --env MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=60.0 --env MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=104857600 --env MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=25.0 --env MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=3600.0 --env MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=256 --transport stdio markdown-vault-mcp -- uvx markdown-vault-mcpcodex mcp add markdown-vault-mcp --env MARKDOWN_VAULT_MCP_KV_STORE_URL=file:///data/state --env MARKDOWN_VAULT_MCP_LOG_LEVEL=INFO --env OLLAMA_HOST=http://localhost:11434 --env OPENAI_API_KEY='<your OPENAI_API_KEY>' --env VOYAGE_API_KEY='<your VOYAGE_API_KEY>' --env MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S=60 --env MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S=60 --env MARKDOWN_VAULT_MCP_CLIENT_TOKEN='<your MARKDOWN_VAULT_MCP_CLIENT_TOKEN>' --env MARKDOWN_VAULT_MCP_SOURCE_DIR=/data/vault --env MARKDOWN_VAULT_MCP_READ_ONLY=false --env MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING=true --env MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS=false --env MARKDOWN_VAULT_MCP_DISABLE_APPS_UI=false --env MARKDOWN_VAULT_MCP_EMBEDDING_STORE=sqlite --env MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB=1 --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN='<your MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>' --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE=4 --env MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S=30.0 --env MARKDOWN_VAULT_MCP_TITLE_FIELD=title --env MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER=_templates --env MARKDOWN_VAULT_MCP_CONVENTIONS_FILE=_conventions.md --env MARKDOWN_VAULT_MCP_OKF_MODE=auto --env MARKDOWN_VAULT_MCP_OKF_WRITE=false --env MARKDOWN_VAULT_MCP_OKF_VERIFY=elicit --env MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB=1.0 --env MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES=262144 --env MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE=auto --env MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE=2 --env MARKDOWN_VAULT_MCP_SNIPPET_WORDS=200 --env MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA=0.25 --env MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS=400 --env MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS=40 --env MARKDOWN_VAULT_MCP_OLLAMA_MODEL=nomic-embed-text --env MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY=false --env MARKDOWN_VAULT_MCP_VOYAGE_MODEL=voyage-4 --env MARKDOWN_VAULT_MCP_OPENAI_BASE_URL=https://api.openai.com/v1 --env MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL=text-embedding-3-small --env MARKDOWN_VAULT_MCP_FASTEMBED_MODEL=BAAI/bge-small-en-v1.5 --env MARKDOWN_VAULT_MCP_EMBED_CONTEXT=false --env MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S=30.0 --env MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE=4 --env MARKDOWN_VAULT_MCP_GIT_TOKEN='<your MARKDOWN_VAULT_MCP_GIT_TOKEN>' --env MARKDOWN_VAULT_MCP_GIT_USERNAME=x-access-token --env MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S=600 --env MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S=30.0 --env MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME=markdown-vault-mcp --env MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL=noreply@markdown-vault-mcp --env MARKDOWN_VAULT_MCP_GIT_LFS=true --env MARKDOWN_VAULT_MCP_FILE_WATCHER=true --env MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S=2.0 --env MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR=true --env MARKDOWN_VAULT_MCP_BOOT_REINDEX=true --env MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET='<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN='<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>' --env MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN='<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY='<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>' --env MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL=gpt-5-mini --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS=8192 --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES=50 --env MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS=200000 --env MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT=120.0 --env MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S=3600.0 --env MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S=86400.0 --env MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S=60.0 --env MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S=60.0 --env MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES=104857600 --env MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S=25.0 --env MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S=3600.0 --env MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT=256 -- uvx markdown-vault-mcpcode --add-mcp '{"name":"markdown-vault-mcp","type":"stdio","command":"uvx","args":["markdown-vault-mcp"],"env":{"MARKDOWN_VAULT_MCP_KV_STORE_URL":"file:///data/state","MARKDOWN_VAULT_MCP_LOG_LEVEL":"INFO","OLLAMA_HOST":"http://localhost:11434","OPENAI_API_KEY":"<your OPENAI_API_KEY>","VOYAGE_API_KEY":"<your VOYAGE_API_KEY>","MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S":"60","MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S":"60","MARKDOWN_VAULT_MCP_CLIENT_TOKEN":"<your MARKDOWN_VAULT_MCP_CLIENT_TOKEN>","MARKDOWN_VAULT_MCP_SOURCE_DIR":"/data/vault","MARKDOWN_VAULT_MCP_READ_ONLY":"false","MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING":"true","MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS":"false","MARKDOWN_VAULT_MCP_DISABLE_APPS_UI":"false","MARKDOWN_VAULT_MCP_EMBEDDING_STORE":"sqlite","MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MB":"1","MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN":"<your MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN>","MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZE":"4","MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_S":"30.0","MARKDOWN_VAULT_MCP_TITLE_FIELD":"title","MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER":"_templates","MARKDOWN_VAULT_MCP_CONVENTIONS_FILE":"_conventions.md","MARKDOWN_VAULT_MCP_OKF_MODE":"auto","MARKDOWN_VAULT_MCP_OKF_WRITE":"false","MARKDOWN_VAULT_MCP_OKF_VERIFY":"elicit","MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB":"1.0","MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES":"262144","MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE":"auto","MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE":"2","MARKDOWN_VAULT_MCP_SNIPPET_WORDS":"200","MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA":"0.25","MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS":"400","MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS":"40","MARKDOWN_VAULT_MCP_OLLAMA_MODEL":"nomic-embed-text","MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY":"false","MARKDOWN_VAULT_MCP_VOYAGE_MODEL":"voyage-4","MARKDOWN_VAULT_MCP_OPENAI_BASE_URL":"https://api.openai.com/v1","MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL":"text-embedding-3-small","MARKDOWN_VAULT_MCP_FASTEMBED_MODEL":"BAAI/bge-small-en-v1.5","MARKDOWN_VAULT_MCP_EMBED_CONTEXT":"false","MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S":"30.0","MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE":"4","MARKDOWN_VAULT_MCP_GIT_TOKEN":"<your MARKDOWN_VAULT_MCP_GIT_TOKEN>","MARKDOWN_VAULT_MCP_GIT_USERNAME":"x-access-token","MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S":"600","MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S":"30.0","MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME":"markdown-vault-mcp","MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL":"noreply@markdown-vault-mcp","MARKDOWN_VAULT_MCP_GIT_LFS":"true","MARKDOWN_VAULT_MCP_FILE_WATCHER":"true","MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S":"2.0","MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR":"true","MARKDOWN_VAULT_MCP_BOOT_REINDEX":"true","MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET":"<your MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>","MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN":"<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>","MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN":"<your MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>","MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY":"<your MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>","MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL":"gpt-5-mini","MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS":"8192","MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES":"50","MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS":"200000","MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT":"120.0","MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S":"3600.0","MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S":"86400.0","MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S":"60.0","MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S":"60.0","MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES":"104857600","MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S":"25.0","MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S":"3600.0","MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT":"256"}}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.
- MARKDOWN_VAULT_MCP_KV_STORE_URLPersistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `mongodb://` each need their matching extra. When unset, defaults to `file:///data/state` (the volume family Docker images mount), or to `memory://` (with a warning) on a host where that directory is not usable.
- MARKDOWN_VAULT_MCP_LOG_LEVELLog level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one major version and logs a deprecation warning.
- OLLAMA_HOSTOllama server URL for the ollama embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the Ollama ecosystem convention.
- OPENAI_API_KEYsecretOpenAI API key for the openai embedding provider, and the fallback key for the summarize tool when MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY is unset. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OpenAI ecosystem convention.
- VOYAGE_API_KEYsecretVoyage AI API key for the voyage embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OPENAI_API_KEY / OLLAMA_HOST convention. Setting it never auto-selects the provider; choose it explicitly with MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=voyage.
- MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_SMaximum seconds an index-backed tool or resource waits for the FTS index to become queryable during a cold-start background build before raising IndexUnavailableError(reason="timeout"). Increase for large vaults.
- MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_SMaximum seconds an index-querying read tool waits for the IndexWriter to drain when called with wait_for_pending_writes=true. On timeout the tool answers from the current index and reports index_stale=true in the response _meta.
- MARKDOWN_VAULT_MCP_CLIENT_TOKENsecretOptional CLI bearer token. A nonempty value overrides the profile-selected token environment source; an empty value leaves that source in effect. Never stored in client TOML.
- MARKDOWN_VAULT_MCP_SOURCE_DIRPath to the markdown vault directory. When it does not exist, or the server cannot access it, the server starts but every tool fails with a message saying which until it is fixed (managed git mode clones into it). Symbolic links inside the vault are followed on Python 3.13+.
- MARKDOWN_VAULT_MCP_READ_ONLYSet to true to hide the write tools (write, edit, append, delete, rename, move_folder, fetch, git_sync, the okf_* tools, create_upload_link) and serve a search-only vault.
- MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTINGRefuse a write that would overwrite an existing file when no if_match etag is supplied. Deliberate replacement still works: read the file first, then pass if_match. Unaffected: edit, append, delete, rename. Set to false to allow blind overwrites.
- MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKSSet to true to have write, edit and append list, under unresolved_links, the target of each link the call added that get_broken_links reports. Links the note already held are left out. Off by default, leaving those responses unchanged.
- MARKDOWN_VAULT_MCP_DISABLE_APPS_UIHide the MCP Apps UI tools (browse_vault, show_context) from the tool listing for clients that do not render MCP Apps panels.
- MARKDOWN_VAULT_MCP_EMBEDDING_STOREWhere embeddings are stored. 'sqlite' (the default) keeps them in one SQLite database beside the index (index-db-embeddings.sqlite3), each change written durably on its own; 'numpy' keeps them in files there and rewrites them all on each save. Without INDEX_PATH or EMBEDDINGS_PATH both keep them in memory. 'postgres' keeps them in a PostgreSQL schema with pgvector (EMBEDDING_POSTGRES_DSN and EMBEDDING_POSTGRES_SCHEMA; the postgres extra).
- MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MBWith EMBEDDING_STORE=sqlite and EMBEDDING_SEARCH=streamed, the embeddings one batch of a search may hold, in MiB (at least 1). It bounds the search's working memory, not the process's; postgres scores in the database and does not use it.
- MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSNsecretWith EMBEDDING_STORE=postgres, the libpq connection string or URI of the database holding the embeddings. A secret: never logged or shown. The password may instead come from PGPASSWORD or a .pgpass file.
- MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZEWith EMBEDDING_STORE=postgres, the most connections the store opens (at least 1).
- MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_SWith EMBEDDING_STORE=postgres, the longest one query may run, in seconds (0 sets none; at most 2147483.647). The bulk write of a full rebuild is never limited.
- MARKDOWN_VAULT_MCP_TITLE_FIELDFrontmatter field used as the document title (falls back to title, the first H1, then the filename). Changing it cold-rebuilds the index once on next startup.
- MARKDOWN_VAULT_MCP_TEMPLATES_FOLDERRelative folder where note templates live (used by the create_from_template prompt).
- MARKDOWN_VAULT_MCP_CONVENTIONS_FILEFilename of the per-folder conventions files surfaced to clients at write time (bare .md filename without glob characters). Set to none to disable folder conventions.
- MARKDOWN_VAULT_MCP_OKF_MODEOKF (Open Knowledge Format) read semantics. With auto (the default), read annotations switch on when the vault declares an OKF version in its root index.md. Use off to disable OKF semantics entirely, or on to force them for an undeclared vault. Annotations are read-only; write behavior is never affected.
- MARKDOWN_VAULT_MCP_OKF_WRITEOKF (Open Knowledge Format) enforced write layer. When true on an OKF-active vault, the server stamps generated provenance on each write and clears any verified attestation when a note's content changes. It also keeps each written folder's log.md and index.md current, and exposes the okf_verify tool. Requires OKF_MODE to be auto or on (a true value with OKF_MODE=off is a config error). Off by default.
- MARKDOWN_VAULT_MCP_OKF_VERIFYHow the okf_verify tool attributes a human review. This applies only when OKF_WRITE is on, which gates the tool. With elicit (the default), okf_verify asks the human to confirm the review through an MCP elicitation, then records the attestation only on an affirmative reply. It fails closed when the client cannot elicit or the human declines, so a model holding the human's token cannot self-attest. Set trust-auth instead to attribute to a token's sub claim with no confirmation; it rejects static bearer credentials, other client-ID-only identities, and OAuth tokens the issuer marks as an application's. This is safe only when the sole caller is a human-driven UI. Set off to hide the tool, leaving attestation to external tooling. A non-default value with OKF_WRITE off is a config error.
- MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MBMaximum attachment size in MB returned by read / accepted by write; 0 disables the limit.
- MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTESMaximum bytes returned by a full-document read of a note; use `read(path, section=…)` for partial reads. 0 disables the limit.
- MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODEMode used when a search call omits 'mode': auto, keyword, semantic, or hybrid. The default 'auto' picks hybrid when embeddings are configured and keyword when they are not. Pin 'keyword' to keep unqualified searches off the embedding provider (each hybrid or semantic search embeds the query, which costs an API call on a metered provider). A configured semantic/hybrid default also degrades to keyword without embeddings, so no setting can make a vault unsearchable; an explicit mode= argument is never downgraded.
- MARKDOWN_VAULT_MCP_CHUNKS_PER_FILEMaximum chunks returned per document in search results.
- MARKDOWN_VAULT_MCP_SNIPPET_WORDSWidth of the snippet window (words) in search results; 0 returns full chunk content.
- MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHADown-weights longer chunks in ranking: score / (1 + alpha * log(chunk_count)).
- MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDSWord cap per chunk; the adaptive chunker splits at deeper heading levels, then paragraph/word boundaries, to respect it. Match it to the embedding model's context. A reindex applies a new value.
- MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDSWords of overlap between adjacent budget-split fragments of the same heading section (0 disables). A reindex applies a new value.
- MARKDOWN_VAULT_MCP_OLLAMA_MODELOllama embedding model name.
- MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLYForce Ollama to embed on CPU only.
- MARKDOWN_VAULT_MCP_VOYAGE_MODELVoyage AI embedding model name.
- MARKDOWN_VAULT_MCP_OPENAI_BASE_URLOpenAI-compatible API base URL for embeddings; the bare OPENAI_BASE_URL is honoured as a fallback.
- MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODELOpenAI-compatible embedding model name; the bare OPENAI_EMBEDDING_MODEL is honoured as a fallback.
- MARKDOWN_VAULT_MCP_FASTEMBED_MODELFastEmbed model name.
- MARKDOWN_VAULT_MCP_EMBED_CONTEXTEnrich embedding input with the note title, chunk heading, and (first chunk) searchable-field values. Flipping it re-embeds the whole vault once on next startup.
- MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_SPer-request wall-clock budget in seconds for a single embedding HTTP call (OpenAI/Ollama). The local FastEmbed backend runs in-process with no network call and ignores this. CPU-only or large-model workloads may need 60-120 s; raise this if batches time out.
- MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZENumber of chunks sent per embedding request. Smaller batches shorten each request (useful under a tight timeout on slow models) at the cost of more round-trips.
- MARKDOWN_VAULT_MCP_GIT_TOKENsecretToken/password for HTTPS git auth; remotes must be HTTPS when set.
- MARKDOWN_VAULT_MCP_GIT_USERNAMEUsername for HTTPS git auth prompts (x-access-token for GitHub, oauth2 for GitLab, the account name for Bitbucket).
- MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_SSeconds between git fetch + fast-forward update attempts; 0 disables periodic pull.
- MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_SSeconds of write-idle time before pushing; 0 pushes only on shutdown.
- MARKDOWN_VAULT_MCP_GIT_COMMIT_NAMEGit committer name for auto-commits, and the author name too unless an OIDC claim supplies one; set this in Docker where git config user.name is empty.
- MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAILGit committer email for auto-commits, and the author email too unless an OIDC claim supplies one.
- MARKDOWN_VAULT_MCP_GIT_LFSRun git lfs pull on startup to fetch LFS-tracked attachments; set to false for repos without LFS.
- MARKDOWN_VAULT_MCP_FILE_WATCHERWatch the vault for external filesystem changes; auto-disabled when git pull is active or a webhook can deliver (HTTP/SSE transports only). Requires the file-watcher extra.
- MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_SSeconds of quiet after the last filesystem event before reindexing.
- MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOORKeep the non-recursive watch on the vault root; set false to register zero source-dir-rooted FSEvents streams (avoids repeated macOS access prompts on a home-rooted vault) at the cost of root-level files relying on scans.
- MARKDOWN_VAULT_MCP_BOOT_REINDEXReconcile offline changes at startup by reindexing once the initial build completes. Set false on a large vault to start without paying a full filesystem scan per server start; changes made while no server was running are then invisible until a reindex runs (the reindex tool, or 'markdown-vault-mcp admin reindex'). `get_index_status` reports `offline_changes` as `not_reconciled` until the server itself runs one; a reindex from the command line updates the index but not that status. Note that `index_stale` reports writer idleness, not agreement with disk, so it reads false while the index may still differ from the vault.
- MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRETsecretShared secret for the GitHub push-event webhook; when set, mounts POST /github-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events.
- MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKENsecretSigning token for the GitLab push-event webhook (GitLab 19.0+); when set, mounts POST /gitlab-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events. GitLab generates this value; copy the `whsec_` token it shows under Generate signing token rather than inventing one. Deliveries are authenticated by HMAC-SHA256 over the webhook id, timestamp and body, and a delivery older than 5 minutes is rejected.
- MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKENsecretSecret token for the GitLab push-event webhook, GitLab's plain-text form and the only one below 19.0; also mounts POST /gitlab-webhook. It proves nothing about the body and cannot expire, so prefer the signing token where the GitLab version offers it. Setting both accepts either, which is how an existing webhook migrates.
- MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEYsecretAPI key for the OpenAI-compatible summarize endpoint; the bare OPENAI_API_KEY is honoured as a fallback. Unset works for keyless local endpoints (Ollama).
- MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODELChat model id used for summaries.
- MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENSUpper bound on generated tokens per summarize call; on reasoning models this budget also covers internal reasoning tokens.
- MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTESCap on the number of notes summarised in one call (subtree expansion truncates to this many).
- MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARSAggregate cap on note characters sent to the model in one call; excess is truncated with a flag on the result.
- MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUTPer-request wall-clock budget in seconds for a single summarize backend call; keep it below the MCP client's request timeout so the server-side error wins the race.
- MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_SLink lifetime in seconds when the caller requests no explicit TTL.
- MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_SCeiling in seconds a caller-requested link TTL is clamped to.
- MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_SPost-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it.
- MARKDOWN_VAULT_MCP_TRANSFER_LEASE_SCrashed-handler reclaim window in seconds for an in-flight reservation.
- MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTESMaximum size in bytes of a single upload.
- MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_SSeconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead.
- MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_SSeconds a background-job record (working or finished) is retained for polling before it expires from the store.
- MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECTMaximum live background jobs per calling subject; further promotions are rejected until older records expire.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Documents & Knowledge
- Version
- 6.1.4
- Registry
- active
- Published
- 11/18/2026
Is it safe? Is it maintained?
Serverdex check: Nov 21, 2026Looks healthy: Markdown Vault MCP is maintained, open source.
- Maintained
- Active
- Last commit 4 days ago (Nov 17, 2026), 204 open issues.
- Official registry
- Active
- Published as io.github.pvliesdonk/markdown-vault-mcp in the official MCP registry, version 6.1.4.
- Source
- Open source, MIT
- Public repository under the MIT licence, 41 stars, 18 forks.
- Runs
- On your machine
- A local PyPI/Docker package started by your client; it can reach whatever your user account can.
- Credentials
- 21 required
- Declared environment variables: OPENAI_API_KEY, VOYAGE_API_KEY, MARKDOWN_VAULT_MCP_CLIENT_TOKEN, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN…. They stay on your machine; the config on this page shows where each goes.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.
On GitHub
read Nov 18, 2026- Stars
- 41
- Forks
- 18
- Last push
- Nov 17, 2026
- License
- MIT
Pythonembeddingsfastmcpfts5knowledge-basemarkdownmarkdown-vault-mcpmcpmcp-servermodel-context-protocolobsidiansearchsemantic-searchvault
From the README
Markdown Vault MCP Generic markdown vault MCP with hybrid search Documentation | Config wizard | PyPI | Docker Give Claude, or any MCP client, a folder of Markdown notes to search, read and write. An Obsidian vault works as it is. • Hybrid search. Keyword search with SQLite FTS5 and, once an embedding provider is configured, search by meaning, fused by Reciprocal Rank Fusion, with the vectors kept in SQLite, files or PostgreSQL. Results are short snippets; read fetches the whole section. See Embeddings and Choosing an embedding store. • Hosted CLI reads. Search a running vault with markdown-vault-mcp search "term" --server https://vault.example/mcp; read notes, list metadata, collect context, traverse note links and discover paths with query path "topic" --fuzzy using the same connection options. Use query metadata, query body or query note for exact lexical pages, query count for the full matching population, and query aggregate --by tag for buckets. Use --json for native payloads or --agent for escaped records. See the CLI reference. • Quiet local reads. Local CLI reads suppress routine INFO logs while retaining warnings and errors. Use -v for diagnostics. See Using the terminal. • Exact queries. Page through indexed notes, count every match, or group the full population with querydocuments, countdocuments and aggregate_documents. See Reader tools and the library API. • Path discovery.…
Read the full README on GitHub →Alternatives to Markdown Vault MCP
All Markdown Vault MCP alternatives →Best Documents & Knowledge servers →The most-starred Documents & Knowledge servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Context7 | 65,010 | Nov 2026 | Working |
| Codebase Memory | 48,994 | Nov 2026 | Local / not checked |
| Reactive Resume | 45,960 | Nov 2026 | Needs sign-in |
| Sui Knowledge Base (kapa.ai) | 7,785 | Nov 2026 | Needs sign-in |
| Agent-Native Slides | 7,735 | Nov 2026 | Needs sign-in |
Markdown Vault MCP: questions people ask
- Is Markdown Vault MCP a remote or a local MCP server?
- According to its entry in the official MCP registry, Markdown Vault MCP ships as a local package (PyPI, Docker) that your client starts on your machine.
- Does Markdown Vault MCP need an API key?
- Its registry entry declares 21 required environment variables: OPENAI_API_KEY, VOYAGE_API_KEY, MARKDOWN_VAULT_MCP_CLIENT_TOKEN, MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSN…. The config on this page shows where each goes.
- Is Markdown Vault MCP safe to use?
- Looks healthy: Markdown Vault MCP is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 21 required. Serverdex check of Nov 21, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Markdown Vault MCP still maintained?
- Active: the repository's last commit 4 days ago. Last push Nov 17, 2026, 41 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
- How do I add Markdown Vault MCP to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More from pvliesdonk
All 3 servers by pvliesdonk →- Scholar MCPScholarly papers, patents, books, standards and PDF conversionDocuments & Knowledge★ 3
- Paperless MCPPaperless-NGX over MCP: search, read, upload and tag documents; manage correspondents and types.Files & Storage★ 1
- Image Generation MCP ServerMCP server for AI image generation via OpenAI, Stable Diffusion (SD WebUI), or placeholders.Media & Creative★ 1
More Documents & Knowledge servers
Browse all Documents & Knowledge →Scholar MCP
pvliesdonk
Scholarly papers, patents, books, standards and PDF conversion
JMeter Docs
QAInsights
Apache JMeter community documentation, conversion tools, linters, and calculators for AI agents.
Qiskit Documentation MCP Server
Qiskit
MCP server for querying and retrieving Qiskit documentation, guides, and API references
SuperLocalMemory
qualixar
Local-first memory for AI agents: recall with sources, answer checks, documents, mesh, governance.
QR Branding
quartzondev
Generate branded, scan-validated QR codes (manual, AI, templates, Wi-Fi, vCard, geo).
Nelson MCP — LibreOffice
quazardous
An MCP server inside LibreOffice: agents read and edit your open Writer and Calc documents.
Add the badge to your site
Show visitors that Markdown Vault MCP is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-pvliesdonk-markdown-vault-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Markdown Vault MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-pvliesdonk-markdown-vault-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-pvliesdonk-markdown-vault-mcp) [](https://serverdex.io/install/vscode/io-github-pvliesdonk-markdown-vault-mcp) [](https://serverdex.io/install/claude-code/io-github-pvliesdonk-markdown-vault-mcp)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-pvliesdonk-markdown-vault-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-pvliesdonk-markdown-vault-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-pvliesdonk-markdown-vault-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).