MCP Server

Local

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.

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.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

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.0.0markdown-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 stars16

Parent forks10

MaintenanceExcellent

Last CommitJun 18, 2026

Actions

Stats

Actions

Tags

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