Stats
Actions
Tags
From markdown-vault-mcp
Provides tools to search, query, and manage a local markdown vault with embeddings and git integration. Supports local LLM via Ollama for semantic search. Requires git token for remote sync.
Copy this JSON into your .mcp.json to enable this server
Add to your .mcp.json:
{
"mcpServers": {
"markdown-vault-mcp": {
"command": "uvx",
"args": [
"--from",
"markdown-vault-mcp[all]==3.0.0",
"markdown-vault-mcp",
"serve"
],
"env": {
"OLLAMA_HOST": "${OLLAMA_HOST:-http://localhost:11434}",
"MARKDOWN_VAULT_MCP_EXCLUDE": "${MARKDOWN_VAULT_MCP_EXCLUDE:-.obsidian/**,.trash/**,.git/**}",
"MARKDOWN_VAULT_MCP_GIT_TOKEN": "${MARKDOWN_VAULT_MCP_GIT_TOKEN:-}",
"MARKDOWN_VAULT_MCP_READ_ONLY": "${MARKDOWN_VAULT_MCP_READ_ONLY:-true}",
"MARKDOWN_VAULT_MCP_INDEX_PATH": "${MARKDOWN_VAULT_MCP_INDEX_PATH:-}",
"MARKDOWN_VAULT_MCP_SOURCE_DIR": "${MARKDOWN_VAULT_MCP_SOURCE_DIR}",
"MARKDOWN_VAULT_MCP_GIT_REPO_URL": "${MARKDOWN_VAULT_MCP_GIT_REPO_URL:-}",
"MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH:-}",
"MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER:-}"
}
}
}
}Replace placeholder values for: MARKDOWN_VAULT_MCP_GIT_TOKEN
Review these signals before enabling this server
This MCP server needs API keys or credentials. Configure them in your environment before use.
Server configuration and connection parameters
uvxCommand-line arguments passed to the server process
Environment variables set when the server starts
OLLAMA_HOST=${OLLAMA_HOST:-http://localhost:11434}MARKDOWN_VAULT_MCP_EXCLUDE=${MARKDOWN_VAULT_MCP_EXCLUDE:-.obsidian/**,.trash/**,.git/**}MARKDOWN_VAULT_MCP_GIT_TOKEN=${MARKDOWN_VAULT_MCP_GIT_TOKEN:-}MARKDOWN_VAULT_MCP_READ_ONLY=${MARKDOWN_VAULT_MCP_READ_ONLY:-true}MARKDOWN_VAULT_MCP_INDEX_PATH=${MARKDOWN_VAULT_MCP_INDEX_PATH:-}MARKDOWN_VAULT_MCP_SOURCE_DIR=${MARKDOWN_VAULT_MCP_SOURCE_DIR}MARKDOWN_VAULT_MCP_GIT_REPO_URL=${MARKDOWN_VAULT_MCP_GIT_REPO_URL:-}MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH=${MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH:-}MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=${MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER:-}Sensitive values you must provide — never committed to source control
npx claudepluginhub pvliesdonk/markdown-vault-mcp