SERVER

Markdown Vault MCP

Rank #1160

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
Apr 23, 2026
OVERVIEW

Markdown Vault MCP is a Model Context Protocol (MCP) server published by pvliesdonk. It ranks #1160 of 58,832 servers tracked on MCP Toplist, and its repository has 11 GitHub stars. Markdown Vault MCP is listed across 2 registries — Official MCP and PulseMCP, with 22 tracked versions. It was first listed on Mar 7, 2026 and most recently updated on Apr 23, 2026.

STANDING
#1,160of 58,832 tracked serversTop 5%

Ranks ahead of 57,672 of 58,832 servers on MCP Toplist.

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>",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "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>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "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_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>"
      }
    }
  }
}

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:v1.13.3"
      ],
      "env": {
        "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_LOG_LEVEL": "<your MARKDOWN_VAULT_MCP_LOG_LEVEL>",
        "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>",
        "EMBEDDING_PROVIDER": "<your EMBEDDING_PROVIDER>",
        "OPENAI_API_KEY": "<your OPENAI_API_KEY>",
        "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_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>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

REGISTRIES

Listed on 2 registries

ORGANIZATION

pvliesdonk

Organization
Total servers
4
Total versions
37
MORE FROM THIS PUBLISHER

Other servers by pvliesdonk

View all pvliesdonk servers →
VERSIONS

Available versions (22)

VersionPublished
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

What is Markdown Vault MCP?
Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing
Who maintains Markdown Vault MCP?
Markdown Vault MCP is maintained by pvliesdonk, which publishes 4 MCP servers (37 total versions) tracked on MCP Toplist.
Is Markdown Vault MCP an official MCP server?
Yes — Markdown Vault MCP is listed on the Official MCP Registry, alongside PulseMCP.
How many versions does Markdown Vault MCP have?
MCP Toplist tracks 22 versions of Markdown Vault MCP, most recently published on Apr 23, 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