Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing
uvx markdown-vault-mcp{
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "/data/vault",
"MARKDOWN_VAULT_MCP_READ_ONLY": "true",
"FASTMCP_LOG_LEVEL": "INFO",
"MARKDOWN_VAULT_MCP_EVENT_STORE_URL": "file:///data/state/events",
"MARKDOWN_VAULT_MCP_SERVER_NAME": "markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_STATE_PATH": "/data/state",
"MARKDOWN_VAULT_MCP_INDEX_PATH": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EXCLUDE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "YOUR_VALUE_HERE",
"OPENAI_API_KEY": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "nomic-embed-text",
"MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "false",
"OLLAMA_HOST": "http://localhost:11434",
"MARKDOWN_VAULT_MCP_GIT_TOKEN": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_GIT_REPO_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_GIT_USERNAME": "x-access-token",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "noreply@markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "30",
"MARKDOWN_VAULT_MCP_GIT_LFS": "true",
"MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "600",
"MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "10",
"MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "_templates",
"MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_AUTH_MODE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_BASE_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "openid",
"MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "false",
"MARKDOWN_VAULT_MCP_APP_DOMAIN": "YOUR_VALUE_HERE",
"PUID": "1000",
"PGID": "1000"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-pvliesdonk-markdown-vault-mcp": {
"command": "uvx",
"args": [
"markdown-vault-mcp"
],
"env": {
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "/data/vault",
"MARKDOWN_VAULT_MCP_READ_ONLY": "true",
"FASTMCP_LOG_LEVEL": "INFO",
"MARKDOWN_VAULT_MCP_EVENT_STORE_URL": "file:///data/state/events",
"MARKDOWN_VAULT_MCP_SERVER_NAME": "markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_STATE_PATH": "/data/state",
"MARKDOWN_VAULT_MCP_INDEX_PATH": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EXCLUDE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "YOUR_VALUE_HERE",
"OPENAI_API_KEY": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "nomic-embed-text",
"MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "false",
"OLLAMA_HOST": "http://localhost:11434",
"MARKDOWN_VAULT_MCP_GIT_TOKEN": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_GIT_REPO_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_GIT_USERNAME": "x-access-token",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "noreply@markdown-vault-mcp",
"MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "30",
"MARKDOWN_VAULT_MCP_GIT_LFS": "true",
"MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "600",
"MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "10",
"MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "_templates",
"MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_BEARER_TOKEN": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_AUTH_MODE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_BASE_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "YOUR_SECRET_VALUE",
"MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "YOUR_VALUE_HERE",
"MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "openid",
"MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "false",
"MARKDOWN_VAULT_MCP_APP_DOMAIN": "YOUR_VALUE_HERE",
"PUID": "1000",
"PGID": "1000"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
Markdown Vault MCP is an MCP server for Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing. It supports STDIO, HTTP transport.
Use the generated config in Install. This server runs with uvx markdown-vault-mcp; add any required environment variables before starting your client.
Choose the Claude Desktop tab in Install and copy the config for uvx markdown-vault-mcp. Add required environment variables before starting Claude Desktop.
Choose the Claude Code tab in Install and copy the config for uvx markdown-vault-mcp. Add required environment variables before starting Claude Code.
Choose the Codex tab in Install and copy the config for uvx markdown-vault-mcp. Add required environment variables before starting Codex.
Choose the Cursor or VS Code tab in Install and copy the config for uvx markdown-vault-mcp. Add required environment variables before starting Cursor or VS Code.
Markdown Vault MCP uses STDIO, HTTP transport. Use the package or command config in Install.
Markdown Vault MCP inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
Markdown Vault MCP is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
markdown-vault-mcpstdio | pypi | 1.27.1 | Env: MARKDOWN_VAULT_MCP_SOURCE_DIR required Env: MARKDOWN_VAULT_MCP_READ_ONLY Env: FASTMCP_LOG_LEVEL Env: MARKDOWN_VAULT_MCP_EVENT_STORE_URL Env: MARKDOWN_VAULT_MCP_SERVER_NAME Env: MARKDOWN_VAULT_MCP_STATE_PATH Env: MARKDOWN_VAULT_MCP_INDEX_PATH Env: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH Env: MARKDOWN_VAULT_MCP_INDEXED_FIELDS Env: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS Env: MARKDOWN_VAULT_MCP_EXCLUDE Env: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER Env: OPENAI_API_KEY secret Env: MARKDOWN_VAULT_MCP_OLLAMA_MODEL Env: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY Env: OLLAMA_HOST Env: MARKDOWN_VAULT_MCP_GIT_TOKEN secret Env: MARKDOWN_VAULT_MCP_GIT_REPO_URL Env: MARKDOWN_VAULT_MCP_GIT_USERNAME Env: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME Env: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL Env: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S Env: MARKDOWN_VAULT_MCP_GIT_LFS Env: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S Env: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS Env: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB Env: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER Env: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER Env: MARKDOWN_VAULT_MCP_BEARER_TOKEN secret Env: MARKDOWN_VAULT_MCP_AUTH_MODE Env: MARKDOWN_VAULT_MCP_BASE_URL Env: MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL Env: MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID Env: MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET secret Env: MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY secret Env: MARKDOWN_VAULT_MCP_OIDC_AUDIENCE Env: MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES Env: MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN Env: MARKDOWN_VAULT_MCP_APP_DOMAIN |
ghcr.io/pvliesdonk/markdown-vault-mcp:v1.27.1streamable-http | oci | Not captured | Argument: --port Env: MARKDOWN_VAULT_MCP_SOURCE_DIR Env: MARKDOWN_VAULT_MCP_READ_ONLY Env: FASTMCP_LOG_LEVEL Env: MARKDOWN_VAULT_MCP_EVENT_STORE_URL Env: MARKDOWN_VAULT_MCP_SERVER_NAME Env: MARKDOWN_VAULT_MCP_STATE_PATH Env: MARKDOWN_VAULT_MCP_INDEX_PATH Env: MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH Env: MARKDOWN_VAULT_MCP_INDEXED_FIELDS Env: MARKDOWN_VAULT_MCP_REQUIRED_FIELDS Env: MARKDOWN_VAULT_MCP_EXCLUDE Env: MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER Env: OPENAI_API_KEY secret Env: MARKDOWN_VAULT_MCP_OLLAMA_MODEL Env: MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY Env: OLLAMA_HOST Env: MARKDOWN_VAULT_MCP_GIT_TOKEN secret Env: MARKDOWN_VAULT_MCP_GIT_REPO_URL Env: MARKDOWN_VAULT_MCP_GIT_USERNAME Env: MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME Env: MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL Env: MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S Env: MARKDOWN_VAULT_MCP_GIT_LFS Env: MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S Env: MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS Env: MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB Env: MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER Env: MARKDOWN_VAULT_MCP_PROMPTS_FOLDER Env: PUID Env: PGID Env: MARKDOWN_VAULT_MCP_BEARER_TOKEN secret Env: MARKDOWN_VAULT_MCP_AUTH_MODE Env: MARKDOWN_VAULT_MCP_BASE_URL Env: MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL Env: MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID Env: MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET secret Env: MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY secret Env: MARKDOWN_VAULT_MCP_OIDC_AUDIENCE Env: MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES Env: MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN Env: MARKDOWN_VAULT_MCP_APP_DOMAIN |