markdown-vault-mcp

Local MCP server for querying and managing markdown vaults with optional embeddings and Git integration. Supports local Ollama or other embedding providers.

Ollama

documentation

developer-tools

Add to Your Project

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.2.0-rc.6",
        "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

Security Considerations

Review these signals before enabling this server

Requires secrets

This MCP server needs API keys or credentials. Configure them in your environment before use.

Details

Server configuration and connection parameters

Commanduvx

Access Levelwrite

Arguments

Command-line arguments passed to the server process

--frommarkdown-vault-mcp[all]==3.2.0-rc.6markdown-vault-mcpserve

Environment Variables

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:-}

Required Secrets

Sensitive values you must provide — never committed to source control

MARKDOWN_VAULT_MCP_GIT_TOKEN

Stats

LanguagePython

Parent stars22

Parent forks11

MaintenanceExcellent

Last CommitJul 17, 2026

Actions

Stats

Actions