Markdown Vault MCP

Generic markdown vault MCP with hybrid search Documentation | Config wizard | PyPI | Docker. It runs locally over stdio via the published package.

People who work with embeddings, fastmcp and fts5 and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-18 · ★ 33 · #26 OF 208 MAINTAINED DOCUMENTATION · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Markdown Vault MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add pvliesdonk-markdown-vault-mcp -- uvx markdown-vault-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "pvliesdonk-markdown-vault-mcp": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

pypi package markdown-vault-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.pvliesdonk is GitHub-verified and matches the repo owner

03 · What Markdown Vault MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v5.0.0 · 2026-09-14

This major release moves the server to FastMCP 4 and makes a fresh Compose · deployment work without a reverse proxy. Writable servers reject blind · whole-file replacement by default, while Python consumers move…

v4.2.0 · 2026-09-13

4.2 makes git-backed vaults safer to trust and draws a clearer boundary around · OKF. An agent can undo an overwrite from the client: an overwriting write · names the commit holding what it replaced, and read accepts a…

v4.1.0 · 2026-08-30

This release is mostly about the server making better choices on its own. A · search call that omits mode now runs the best mode the vault can actually · serve, so a vault with embeddings built stops answering…

04 · Who maintains Markdown Vault MCP

Markdown Vault MCP is maintained by pvliesdonk. We track 5 MCP servers from pvliesdonk - 5 actively maintained, 37 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from pvliesdonk.

Scholar MCP FastMCP server for scholarly papers, patents, books and standards with docling PDF conversion ★ 2

05 · Facts

repository: github.com/pvliesdonk/markdown-vault-mcp
website: https://pvliesdonk.github.io/markdown-vault-mcp/
category: documentation - ranked #26 of 208 actively-maintained documentation servers as of 2026-09-18.
release cadence: 4 releases in the last 90 days (latest 2026-09-14)
registry: io.github.pvliesdonk/markdown-vault-mcp (active, first published 2026-03-18 · 30 versions)
packages: pypi:markdown-vault-mcp · oci:ghcr.io/pvliesdonk/markdown-vault-mcp:v4.2.0

06 · Markdown Vault MCP FAQ

What is Markdown Vault MCP?

Generic markdown vault MCP with hybrid search Documentation | Config wizard | PyPI | Docker. It runs locally over stdio via the published package.

Is Markdown Vault MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-18 and it shipped 4 releases in the last 90 days. We re-verify nightly.

How do I install Markdown Vault MCP?

Run `uvx markdown-vault-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Markdown Vault MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Markdown Vault MCP

Alternatives to Markdown Vault MCP

Maintained documentation servers if Markdown Vault MCP isn't the fit.

Pairs well with

Servers that cover what Markdown Vault MCP doesn't - only shown when the pairing reason fits the companion.

More documentation MCP servers · JMeter Docs · Qingkuai MCP Server · Qiskit Documentation MCP Server · Qveris · Doc Guard

More Python MCP servers · Scholar MCP (pvliesdonk) · Aiogram MCP · Godot Lens · build123d MCP · Ouroboros · see all