Markdown Vault MCP
Generic markdown vault MCP with hybrid search
MCP server · by pvliesdonk
About
Markdown Vault MCP is an MCP server published by pvliesdonk. Marketplaces we read that list it: 1 (Official MCP Registry). We first saw it on 2026-10-11 and have recorded no change since. As of our marketplace pass on 2026-10-13.
What it asks for
- Runs on your machine
- Secrets: 10
- Settings: 110
Requires: MARKDOWN_VAULT_MCP_BEARER_TOKEN (secret), MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET (secret), MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN (secret), MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN (secret), MARKDOWN_VAULT_MCP_GIT_TOKEN (secret), MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET (secret), MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY (secret), MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY (secret), OPENAI_API_KEY (secret), VOYAGE_API_KEY (secret)
What it declares, asks for and runs, in full
Only install plugins from developers you trust. We list what marketplaces publish and do not test plugins.
Package
PyPI markdown-vault-mcp (markdown-vault-mcp on PyPI)
- PyPI downloads/week: 695 (2026-10-13)
- PyPI downloads/month: 1 927 (2026-10-13)
- Latest version on PyPI: 5.1.0, published 2026-10-07
No known vulnerabilities in OSV for 5.1.0 (checked 2026-10-13)
PyPI facts come from pypi.org, PyPI downloads from pypistats.org. Each figure is the registry's own and is never added to another. A registry that publishes no figure shows none: no number is not zero. Vulnerability records come from OSV.dev (CC BY 4.0) and concern the declared version only; a listing that declares no version gets no answer. We do not scan code.
Works with
- Claude Code
- Codex
- Cursor
- VS Code
- Copilot CLI
From the marketplaces that list it and the MCP transport it declares, as each client documents them. We do not test plugins.
Connect
Commands and configs built only from what its marketplaces declare. We do not run them for you and do not test plugins.
As a local MCP server: PyPI package
Built from what Official MCP Registry declares.
claude mcp add --env "MARKDOWN_VAULT_MCP_BEARER_TOKEN=<YOUR_MARKDOWN_VAULT_MCP_BEARER_TOKEN>" --env "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET=<YOUR_MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>" --env "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN=<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>" --env "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN=<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>" --env "MARKDOWN_VAULT_MCP_GIT_TOKEN=<YOUR_MARKDOWN_VAULT_MCP_GIT_TOKEN>" --env "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET=<YOUR_MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET>" --env "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY=<YOUR_MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY>" --env "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY=<YOUR_MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>" --env "OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>" --env "VOYAGE_API_KEY=<YOUR_VOYAGE_API_KEY>" --transport stdio markdown-vault-mcp -- uvx markdown-vault-mcp[mcp_servers.markdown-vault-mcp]
command = "uvx"
args = ["markdown-vault-mcp"]
[mcp_servers.markdown-vault-mcp.env]
MARKDOWN_VAULT_MCP_BEARER_TOKEN = "<YOUR_MARKDOWN_VAULT_MCP_BEARER_TOKEN>"
MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET = "<YOUR_MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>"
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN = "<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>"
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN = "<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>"
MARKDOWN_VAULT_MCP_GIT_TOKEN = "<YOUR_MARKDOWN_VAULT_MCP_GIT_TOKEN>"
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_SUMMARIZE_OPENAI_API_KEY = "<YOUR_MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>"
OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"
VOYAGE_API_KEY = "<YOUR_VOYAGE_API_KEY>"{
"mcpServers": {
"markdown-vault-mcp": {
"command": "uvx",
"args": [
"markdown-vault-mcp"
],
"env": {
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "<YOUR_MARKDOWN_VAULT_MCP_BEARER_TOKEN>",
"MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<YOUR_MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
"MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
"MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<YOUR_MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
"MARKDOWN_VAULT_MCP_GIT_TOKEN": "<YOUR_MARKDOWN_VAULT_MCP_GIT_TOKEN>",
"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_SUMMARIZE_OPENAI_API_KEY": "<YOUR_MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"VOYAGE_API_KEY": "<YOUR_VOYAGE_API_KEY>"
}
}
}
}Replace the values in angle brackets with your own. We show the names of the settings, never values.
Optional settings it also lists: MARKDOWN_VAULT_MCP_APP_DOMAIN, MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS, MARKDOWN_VAULT_MCP_AUTH_MODE, MARKDOWN_VAULT_MCP_BASE_URL, MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECT, MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILE, MARKDOWN_VAULT_MCP_BOOT_REINDEX, MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S, MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE, MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS, MARKDOWN_VAULT_MCP_CONVENTIONS_FILE, MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE, MARKDOWN_VAULT_MCP_DISABLE_APPS_UI, MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S, MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH, MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE, MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER, MARKDOWN_VAULT_MCP_EMBED_CONTEXT, MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S, MARKDOWN_VAULT_MCP_EXCLUDE, MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR, MARKDOWN_VAULT_MCP_FASTEMBED_MODEL, MARKDOWN_VAULT_MCP_FILE_WATCHER, MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S, MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR, MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS, MARKDOWN_VAULT_MCP_FTS_WEIGHTS, MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL, MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM, MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME, MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM, MARKDOWN_VAULT_MCP_GIT_LFS, MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S, MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S, MARKDOWN_VAULT_MCP_GIT_REPO_URL, MARKDOWN_VAULT_MCP_GIT_USERNAME, MARKDOWN_VAULT_MCP_HEALTH_DETAIL, MARKDOWN_VAULT_MCP_HTTP_PATH, MARKDOWN_VAULT_MCP_INDEXED_FIELDS, MARKDOWN_VAULT_MCP_INDEX_PATH, MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION, MARKDOWN_VAULT_MCP_INSTRUCTIONS, MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA, MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT, MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S, MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S, MARKDOWN_VAULT_MCP_KV_STORE_URL, MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA, MARKDOWN_VAULT_MCP_LOG_FORMAT, MARKDOWN_VAULT_MCP_LOG_LEVEL, MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB, MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS, MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS, MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES, MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPES, MARKDOWN_VAULT_MCP_OIDC_AUDIENCE, MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID, MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL, MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES, MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN, MARKDOWN_VAULT_MCP_OKF_MODE, MARKDOWN_VAULT_MCP_OKF_VERIFY, MARKDOWN_VAULT_MCP_OKF_WRITE, MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY, MARKDOWN_VAULT_MCP_OLLAMA_MODEL, MARKDOWN_VAULT_MCP_OPENAI_BASE_URL, MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL, MARKDOWN_VAULT_MCP_PROMPTS_FOLDER, MARKDOWN_VAULT_MCP_READ_ONLY, MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS, MARKDOWN_VAULT_MCP_REQUIRED_FIELDS, MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS, MARKDOWN_VAULT_MCP_SERVER_NAME, MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_S, MARKDOWN_VAULT_MCP_SNIPPET_WORDS, MARKDOWN_VAULT_MCP_SOURCE_DIR, MARKDOWN_VAULT_MCP_STATE_PATH, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES, MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL, MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER, MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT, MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER, MARKDOWN_VAULT_MCP_TITLE_FIELD, MARKDOWN_VAULT_MCP_TOOLS_ALLOW, MARKDOWN_VAULT_MCP_TOOLS_DENY, MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S, MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S, MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES, MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S, MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S, MARKDOWN_VAULT_MCP_VOYAGE_MODEL, MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING, OLLAMA_HOST, OPENAI_BASE_URL, OPENAI_EMBEDDING_MODEL, PGID, PUID.
Where it is published
| Marketplace | Status | Version | Figures | Verified | First seen |
|---|---|---|---|---|---|
| Official MCP Registry (Open the registry record) | Listed | 5.1.0 | Downloads/month (PyPI): 1 927 Downloads/week (PyPI): 695 Forks (GitHub): 12 Stars (GitHub): 34 |
Not marked |
Each figure is the marketplace's own and is never added up across marketplaces. A marketplace that publishes no figure shows none: no number is not zero.
What changed
Nothing has moved on this plugin since we started watching it.
Similar plugins
Products whose own names, descriptions, tools and skills are closest in meaning to this one, on every marketplace we read. Closeness is ranked within this list only.
-
datacron io.github.VBlackJack/datacron
Local-first MCP server that exposes a Markdown vault through MCP.
-
Indexed search, schema-checked writes and session hooks for a markdown notes vault
-
Local-only MCP server for source-attributed Markdown memory and documentation retrieval.
-
compendio-mcp io.github.RuloGB/compendio-mcp
Indexes your project's markdown docs and serves them to any agent via local hybrid search.
-
Section-level doc search for .md, .rst, .adoc, .ipynb, .html, .yaml, .json, and OpenAPI specs.
-
Local Markdown search, navigation and editing via MCP, with optional vector embeddings.
-
Read-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.
-
Local read-only semantic search for Markdown vaults through MCP.
-
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
-
Access Obsidian vaults via Local REST API - read, search, and interact with notes
Similar plugins by marketplace
The same question asked of one marketplace at a time: is there an analog of this plugin there?
Has a listing on Claude Code: claude-plugins-community (5)
-
Zero-config MCP server for searchable documentation. SQLite or PostgreSQL.
-
mdshare io.github.sathya-sankaran/mdshare
Free markdown sharing. Upload, get links, collaborate. No login needed.
-
Connect AI assistants to Outline for document search, reading, and management
-
Local-first knowledge vaults for project docs and specs. Tagged, versioned, full-text searchable.
-
Second Brain automation for Obsidian vaults — entity management, ingestion, compression, and sync via Claude Code skills
Has a listing on Claude Code: claude-plugins-official (5)
-
Tools to maintain and improve CLAUDE.md files - audit quality, capture session learnings, and keep project memory current.
-
MCP server for terminal commands, file operations, and process management
-
Sanity content platform integration with MCP server, agent skills, and slash commands. Query and author content, build and optimize GROQ queries, design schemas, and set up Visual…
-
Build beautiful documentation sites with Mintlify. Convert non-markdown files into properly formatted MDX pages, add and modify content with correct component use, and automate…
-
Upstash Context7 MCP server for up-to-date documentation lookup. Connects to Context7's hosted remote MCP server (https://mcp.context7.com/mcp) — no local Node.js or npx required…
Has a listing on Claude: knowledge-work-plugins (5)
-
MCP server for terminal commands, file operations, and process management
-
Sanity content platform integration with MCP server, agent skills, and slash commands. Query and author content, build and optimize GROQ queries, design schemas, and set up Visual…
-
Build beautiful documentation sites with Mintlify. Convert non-markdown files into properly formatted MDX pages, add and modify content with correct component use, and automate…
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Connect sources and search processed documents with Unstructured Foundation. Provides MCP access to source setup, processing status, document search, and document retrieval.
Has a listing on Codex: openai-curated (openai/plugins) (5)
-
Use MagicPath to find, inspect, install, create, and edit UI components from Codex.
-
Work with SharePoint using the configured Microsoft SharePoint app connector.
-
Evaluate Codex skills and plugins from chat with a beginner-friendly start command, local-first reports, token budget explanations, and guided benchmarking.
-
Cloudflare platform plugin with curated skills for Workers, Wrangler, and Agents SDK plus the official Cloudflare API MCP server.
-
Inspect repositories, triage pull requests and issues, debug CI, and publish changes through a hybrid GitHub connector and CLI workflow.
Has a listing on Community GitHub marketplaces (5)
-
Section-level doc search for .md, .rst, .adoc, .ipynb, .html, .yaml, .json, and OpenAPI specs.
-
stellavault io.github.Evanciel/stellavault
Local-first MCP server: Claude searches, asks & drafts from your Obsidian vault. 21 tools, no keys.
-
FastMCP server for bidirectional sync between personal and team Obsidian vaults
FastMCP server for bidirectional sync between personal and team Obsidian vaults.
-
FastMCP server exposing Joplin notes, notebooks, tags, and imports.
-
Git-native content governance for AI agents — 27 deterministic MCP tools over stdio and HTTP.
Has a listing on Copilot CLI: github/awesome-copilot (5)
-
Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a…
-
Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating…
-
Figma design platform integration. Access design files, extract component information, read design tokens, and translate designs into code. Bridge the gap between design and…
-
Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best…
-
Create, edit, present, and export Markdown slides in a GitHub Copilot Canvas.
Has a listing on Copilot CLI: github/copilot-plugins (5)
-
mcp-apps
Generate MCP App widgets for MCP tools. Produces self-contained HTML widgets using the MCP Apps protocol.
-
Toolkit for building Microsoft 365 Copilot declarative agents — scaffolding, JSON manifest development, and capability configuration.
-
Build Power Apps Canvas Apps using the Canvas Authoring MCP server.
-
workiq
Query Microsoft 365 data with natural language — emails, meetings, documents, Teams messages, and more.
-
Bring Azure DevOps work-item, repository, and pull-request workflows into GitHub Copilot.
Has a listing on Cursor: cursor/plugins (5)
-
Capture, search, and organize notes and collections.
-
Search docs, read pages, and update tables.
-
Render documentation as a navigable canvas.
-
Let Grok Bot reach MCP servers on your private Tailscale network. Sign in to Tailscale to connect your tailnet; Grok Bot joins it as one tagged device and only reaches the hosts…
-
Search and read Microsoft SharePoint sites, document libraries, files, and lists.
Has a listing on Docker MCP Catalog (5)
-
The Official Model Context Protocol (MCP) server for Kagi Search & other tools.
-
A lightweight MCP server for calling MarkItDown.
-
Production-ready RAG service to search and retrieve data from your documents.
-
MCP server that interacts with Obsidian via the Obsidian rest API community plugin.
-
MCP server for terminal commands, file operations, and process management
Has a listing on Official MCP Registry (5)
-
datacron io.github.VBlackJack/datacron
Local-first MCP server that exposes a Markdown vault through MCP.
-
Indexed search, schema-checked writes and session hooks for a markdown notes vault
-
Local-only MCP server for source-attributed Markdown memory and documentation retrieval.
-
compendio-mcp io.github.RuloGB/compendio-mcp
Indexes your project's markdown docs and serves them to any agent via local hybrid search.
-
Section-level doc search for .md, .rst, .adoc, .ipynb, .html, .yaml, .json, and OpenAPI specs.
Found by meaning, not by shared code or a shared repository: similar plugins stay separate products, and this is not a review or a recommendation.
Is this your plugin?
Add it to your projects and prove you maintain it with a file in its repository, a file on your domain or a DNS record. You get alerts when a marketplace lists it, drops it, changes its verified mark or what it asks for, and its remote endpoint goes on monitoring as a web service.
Data comes from the Official MCP Registry (registry.modelcontextprotocol.io), CC0 1.0. Figures come from our own regular passes over the marketplaces, last read on . We publish no contact details for plugin publishers.