Markdown Vault MCP
Rank #845io.github.pvliesdonk/markdown-vault-mcp
Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing
Markdown Vault MCP is a Model Context Protocol (MCP) server published by pvliesdonk. It ranks #845 of 76,851 servers tracked on MCP Toplist, and its repository has 22 GitHub stars. Markdown Vault MCP is listed across 3 registries — Official MCP, PulseMCP and Glama, with 23 tracked versions. It was first listed on Mar 7, 2026 and most recently updated on Jun 27, 2026.
Ranks ahead of 76,006 of 76,851 servers on MCP Toplist.
Use Markdown Vault MCP
Add Markdown Vault MCP to any MCP client (Claude, Cursor, VS Code, …) with one of the configs below.
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "uvx",
"args": [
"markdown-vault-mcp"
],
"env": {
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
"MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
"FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
"MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
"MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
"MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
"MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_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_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
"OPENAI_API_KEY": "<your OPENAI_API_KEY>",
"OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
"OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
"MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
"MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
"OLLAMA_HOST": "<your OLLAMA_HOST>",
"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_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_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
"MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
"MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
"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_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
"MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
"MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
"MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
"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_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
"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_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
"MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>"
}
}
}
}Replace each placeholder with your own value before saving.
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/pvliesdonk/markdown-vault-mcp:v3.0.4"
],
"env": {
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "<your MARKDOWN_VAULT_MCP_SOURCE_DIR>",
"MARKDOWN_VAULT_MCP_READ_ONLY": "<your MARKDOWN_VAULT_MCP_READ_ONLY>",
"FASTMCP_LOG_LEVEL": "<your FASTMCP_LOG_LEVEL>",
"MARKDOWN_VAULT_MCP_KV_STORE_URL": "<your MARKDOWN_VAULT_MCP_KV_STORE_URL>",
"MARKDOWN_VAULT_MCP_SERVER_NAME": "<your MARKDOWN_VAULT_MCP_SERVER_NAME>",
"MARKDOWN_VAULT_MCP_STATE_PATH": "<your MARKDOWN_VAULT_MCP_STATE_PATH>",
"MARKDOWN_VAULT_MCP_INDEX_PATH": "<your MARKDOWN_VAULT_MCP_INDEX_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_EMBEDDING_PROVIDER": "<your MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
"OPENAI_API_KEY": "<your OPENAI_API_KEY>",
"OPENAI_BASE_URL": "<your OPENAI_BASE_URL>",
"OPENAI_EMBEDDING_MODEL": "<your OPENAI_EMBEDDING_MODEL>",
"MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<your MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
"MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<your MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
"OLLAMA_HOST": "<your OLLAMA_HOST>",
"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_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_PUSH_DELAY_S": "<your MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
"MARKDOWN_VAULT_MCP_GIT_LFS": "<your MARKDOWN_VAULT_MCP_GIT_LFS>",
"MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<your MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
"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_TEMPLATES_FOLDER": "<your MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
"MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<your MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
"PUID": "<your PUID>",
"PGID": "<your PGID>",
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<your MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
"MARKDOWN_VAULT_MCP_AUTH_MODE": "<your MARKDOWN_VAULT_MCP_AUTH_MODE>",
"MARKDOWN_VAULT_MCP_BASE_URL": "<your MARKDOWN_VAULT_MCP_BASE_URL>",
"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_JWT_SIGNING_KEY": "<your MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>",
"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_VERIFY_ACCESS_TOKEN": "<your MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN>",
"MARKDOWN_VAULT_MCP_APP_DOMAIN": "<your MARKDOWN_VAULT_MCP_APP_DOMAIN>"
}
}
}
}Replace each placeholder with your own value before saving.
Listed on 2 registries (1 delisted)
pvliesdonk
Other servers by pvliesdonk
- Image Generation MCP Server#5,020 · 8 vers
- Scholar MCP Server#5,741 · 8 vers
- Paperless MCP#8,990 · 5 vers
- Logo.dev MCP#9,618 · 1 ver
- Kroki MCP#60,861
Available versions (23)
| Version | Published |
|---|---|
| 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 |
Frequently asked questions
- Who maintains Markdown Vault MCP?
- Markdown Vault MCP is maintained by pvliesdonk, which publishes 6 MCP servers (45 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 23 versions of Markdown Vault MCP, most recently published on Jun 27, 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.