# Markdown Vault MCP MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-pvliesdonk-markdown-vault-mcp
- Repository: https://github.com/pvliesdonk/markdown-vault-mcp
- Website: https://pvliesdonk.github.io/markdown-vault-mcp/

## Install
- Command: `uvx markdown-vault-mcp`
- Auth: Auth required by registry metadata

## Setup notes
- Package: Pypi markdown-vault-mcp v1.27.1
- Environment variable: MARKDOWN_VAULT_MCP_SOURCE_DIR (required)
- Environment variable: MARKDOWN_VAULT_MCP_READ_ONLY (default true)
- Environment variable: FASTMCP_LOG_LEVEL (default INFO; choices DEBUG, INFO, WARNING, ERROR)
- Environment variable: MARKDOWN_VAULT_MCP_EVENT_STORE_URL (default file:///data/state/events)
- Environment variable: MARKDOWN_VAULT_MCP_SERVER_NAME (default markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_STATE_PATH
- Environment variable: MARKDOWN_VAULT_MCP_INDEX_PATH
- Environment variable: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
- Environment variable: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
- Environment variable: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
- Environment variable: MARKDOWN_VAULT_MCP_EXCLUDE
- Environment variable: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER (choices openai, ollama, fastembed, fastembed-gpu)
- Environment variable: OPENAI_API_KEY (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_MODEL (default nomic-embed-text)
- Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY (default false)
- Environment variable: OLLAMA_HOST (default http://localhost:11434)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_TOKEN (secret)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_REPO_URL
- Environment variable: MARKDOWN_VAULT_MCP_GIT_USERNAME (default x-access-token)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME (default markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL (default noreply@markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S (default 30)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_LFS (default true)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S (default 600)
- Environment variable: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
- Environment variable: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB (default 10)
- Environment variable: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER (default _templates)
- Environment variable: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
- Environment variable: MARKDOWN_VAULT_MCP_BEARER_TOKEN (secret)
- Environment variable: MARKDOWN_VAULT_MCP_AUTH_MODE
- Environment variable: MARKDOWN_VAULT_MCP_BASE_URL
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_AUDIENCE
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES (default openid)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN (default false)
- Environment variable: MARKDOWN_VAULT_MCP_APP_DOMAIN
- Package: Oci ghcr.io/pvliesdonk/markdown-vault-mcp:v1.27.1
- Package argument: --port (default 8000)
- Environment variable: MARKDOWN_VAULT_MCP_SOURCE_DIR (default /data/vault)
- Environment variable: MARKDOWN_VAULT_MCP_READ_ONLY (default true)
- Environment variable: FASTMCP_LOG_LEVEL (default INFO; choices DEBUG, INFO, WARNING, ERROR)
- Environment variable: MARKDOWN_VAULT_MCP_EVENT_STORE_URL (default file:///data/state/events)
- Environment variable: MARKDOWN_VAULT_MCP_SERVER_NAME (default markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_STATE_PATH (default /data/state)
- Environment variable: MARKDOWN_VAULT_MCP_INDEX_PATH
- Environment variable: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
- Environment variable: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
- Environment variable: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
- Environment variable: MARKDOWN_VAULT_MCP_EXCLUDE
- Environment variable: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER (choices openai, ollama, fastembed, fastembed-gpu)
- Environment variable: OPENAI_API_KEY (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_MODEL (default nomic-embed-text)
- Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY (default false)
- Environment variable: OLLAMA_HOST (default http://localhost:11434)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_TOKEN (secret)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_REPO_URL
- Environment variable: MARKDOWN_VAULT_MCP_GIT_USERNAME (default x-access-token)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME (default markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL (default noreply@markdown-vault-mcp)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S (default 30)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_LFS (default true)
- Environment variable: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S (default 600)
- Environment variable: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
- Environment variable: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB (default 10)
- Environment variable: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER (default _templates)
- Environment variable: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
- Environment variable: PUID (default 1000)
- Environment variable: PGID (default 1000)
- Environment variable: MARKDOWN_VAULT_MCP_BEARER_TOKEN (secret)
- Environment variable: MARKDOWN_VAULT_MCP_AUTH_MODE
- Environment variable: MARKDOWN_VAULT_MCP_BASE_URL
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY (secret)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_AUDIENCE
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES (default openid)
- Environment variable: MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN (default false)
- Environment variable: MARKDOWN_VAULT_MCP_APP_DOMAIN
- The upstream registry signals required auth or secrets.

## Tools
Not captured

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.pvliesdonk
- Version: 1.27.1
- Runtime: Oci, Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 23, 2026
- Source: https://registry.modelcontextprotocol.io