markdown-vault-mcp

Provides local access to a markdown vault (Obsidian-style) with full-text search, reading, editing, and file management. Supports git versioning, local LLM embeddings via Ollama, and optional read-only mode.

Ollama

developer-tools

documentation

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.1",
        "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.1markdown-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 stars17

Parent forks10

MaintenanceExcellent

Last CommitJun 22, 2026

Actions

Stats

Actions

Tags

{ "mcpServers": { "markdown-vault-mcp": { "command": "uvx", "args": [ "--from", "markdown-vault-mcp[all]==3.0.1", "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:-}" } } } }