SERVER

Markdown Vault MCP

Rank #845

io.github.pvliesdonk/markdown-vault-mcp

Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing

First listed
Mar 7, 2026
Last publish date
Jun 27, 2026
OVERVIEW

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.

STANDING
#845of 76,851 tracked serversTop 5%

Ranks ahead of 76,006 of 76,851 servers on MCP Toplist.

Recent momentum
+16GitHub stars since Apr 27 (+267%)
CONNECT

Use Markdown Vault MCP

Add Markdown Vault MCP to any MCP client (Claude, Cursor, VS Code, …) with one of the configs below.

Python package (PyPI)
{
  "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.

Docker image
{
  "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.

REGISTRIES

Listed on 2 registries (1 delisted)

PulseMCPDelisted · last seen Jun 4, 2026
ORGANIZATION

pvliesdonk

Organization
Servers in org
6
Versions across org
45
MORE FROM THIS PUBLISHER

Other servers by pvliesdonk

View all pvliesdonk servers →
VERSIONS

Available versions (23)

0.1.0 · Nov 25, 20241.13.1 · Mar 18, 20261.13.3 · Mar 19, 20261.13.4 · Mar 19, 20261.14.0 · Mar 19, 20261.15.0 · Mar 21, 20261.16.0 · Mar 23, 20261.17.0 · Mar 24, 20261.18.0 · Mar 31, 20261.18.1 · Apr 2, 20261.19.0 · Apr 4, 20261.19.1 · Apr 4, 20261.20.0 · Apr 8, 20261.20.1 · Apr 10, 20261.21.0 · Apr 10, 20261.22.0 · Apr 16, 20261.22.1 · Apr 17, 20261.23.0 · Apr 19, 20261.23.1 · Apr 20, 20261.25.0 · Apr 20, 20261.27.0 · Apr 21, 20261.27.1 · Apr 23, 20263.0.4 · Jun 27, 2026Nov 25, 2024Jun 27, 2026
VersionPublished
3.0.4Jun 27, 2026
1.27.1Apr 23, 2026
1.27.0Apr 21, 2026
1.25.0Apr 20, 2026
1.23.1Apr 20, 2026
1.23.0Apr 19, 2026
1.22.1Apr 17, 2026
1.22.0Apr 16, 2026
1.21.0Apr 10, 2026
1.20.1Apr 10, 2026
1.20.0Apr 8, 2026
1.19.1Apr 4, 2026
1.19.0Apr 4, 2026
1.18.1Apr 2, 2026
1.18.0Mar 31, 2026
1.17.0Mar 24, 2026
1.16.0Mar 23, 2026
1.15.0Mar 21, 2026
1.14.0Mar 19, 2026
1.13.4Mar 19, 2026
1.13.3Mar 19, 2026
1.13.1Mar 18, 2026
0.1.0Nov 25, 2024
FAQ

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.
EXPLORE