Back to Browse
Free
Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing
About
Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (1 strong, 2 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (3/3 approved).
5 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
What You'll Need
Set these up before or after installing:
Absolute path to the markdown vault directory
Environment variable: MARKDOWN_VAULT_MCP_SOURCE_DIR
Disable write tools
Environment variable: MARKDOWN_VAULT_MCP_READ_ONLY
Log level for FastMCP internals; app loggers default to INFO, -v overrides both to DEBUG
Environment variable: FASTMCP_LOG_LEVEL
Event store backend for HTTP session persistence (file:///path or memory://)
Environment variable: MARKDOWN_VAULT_MCP_EVENT_STORE_URL
MCP server name shown to clients
Environment variable: MARKDOWN_VAULT_MCP_SERVER_NAME
Directory for index and embeddings state files
Environment variable: MARKDOWN_VAULT_MCP_STATE_PATH
Path to the FTS5 SQLite index file
Environment variable: MARKDOWN_VAULT_MCP_INDEX_PATH
Path to the numpy embeddings file
Environment variable: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH
Comma-separated frontmatter fields to index for search
Environment variable: MARKDOWN_VAULT_MCP_INDEXED_FIELDS
Comma-separated frontmatter fields required on every document
Environment variable: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS
Comma-separated glob patterns to exclude from indexing
Environment variable: MARKDOWN_VAULT_MCP_EXCLUDE
Embedding provider to use
Environment variable: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER
OpenAI API key (required when MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=openai)Required
Environment variable: OPENAI_API_KEY
Ollama embedding model name
Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_MODEL
Force CPU-only inference for Ollama
Environment variable: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY
Ollama server base URL
Environment variable: OLLAMA_HOST
Git authentication token for push/pullRequired
Environment variable: MARKDOWN_VAULT_MCP_GIT_TOKEN
Remote git repository URL for managed mode
Environment variable: MARKDOWN_VAULT_MCP_GIT_REPO_URL
Git username for token auth
Environment variable: MARKDOWN_VAULT_MCP_GIT_USERNAME
Git committer name
Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME
Git committer email
Environment variable: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL
Seconds to wait before pushing (batches writes)
Environment variable: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S
Enable Git LFS support
Environment variable: MARKDOWN_VAULT_MCP_GIT_LFS
Seconds between periodic git pulls (0 to disable)
Environment variable: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S
Comma-separated allowed attachment extensions, or * for all
Environment variable: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS
Maximum attachment size in MB (0 for unlimited)
Environment variable: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB
Folder name for note templates within the vault
Environment variable: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER
Path to user-defined MCP prompt templates
Environment variable: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER
Bearer token for authenticationRequired
Environment variable: MARKDOWN_VAULT_MCP_BEARER_TOKEN
OIDC auth mode: 'remote' (JWKS validation) or 'oidc-proxy' (OAuth proxy). Auto-detected if not set.
Environment variable: MARKDOWN_VAULT_MCP_AUTH_MODE
Public base URL of this server (required for OIDC)
Environment variable: MARKDOWN_VAULT_MCP_BASE_URL
OIDC discovery endpoint URL
Environment variable: MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL
OIDC client ID
Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID
OIDC client secretRequired
Environment variable: MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET
Signing key for OIDC session JWTs (critical on Linux/Docker)Required
Environment variable: MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY
Expected OIDC token audience
Environment variable: MARKDOWN_VAULT_MCP_OIDC_AUDIENCE
Space-separated required OIDC scopes
Environment variable: MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES
Verify access token JWT instead of id_token
Environment variable: MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN
Override Claude app domain for MCP Apps iframe sandboxing
Environment variable: MARKDOWN_VAULT_MCP_APP_DOMAIN
Run as this UID (Docker entrypoint)
Environment variable: PUID
Run as this GID (Docker entrypoint)
Environment variable: PGID
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-pvliesdonk-markdown-vault-mcp": {
"env": {
"MARKDOWN_VAULT_MCP_READ_ONLY": "your-markdown-vault-mcp-read-only-here",
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "your-markdown-vault-mcp-source-dir-here",
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "your-markdown-vault-mcp-bearer-token-here",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "your-markdown-vault-mcp-oidc-client-id-here",
"MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "your-markdown-vault-mcp-oidc-config-url-here",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "your-markdown-vault-mcp-oidc-client-secret-here"
},
"args": [
"markdown-vault-mcp"
],
"command": "uvx"
}
}
}Reviews
No reviews yet
Be the first to review this server!
More Security MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
404
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
89.9K
Stars
14
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
13
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI
1.6K
Stars
11
Installs
7.0
Security
No ratings yet
Local