HotStack

← Back to browse

Markdown Vault MCP

Indexed by io.github.pvliesdonk
View source ↗

About

Markdown vault MCP server with FTS5 + semantic search and frontmatter indexing

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)
Env varsMARKDOWN_VAULT_MCP_SOURCE_DIR MARKDOWN_VAULT_MCP_READ_ONLY FASTMCP_LOG_LEVEL MARKDOWN_VAULT_MCP_KV_STORE_URL MARKDOWN_VAULT_MCP_SERVER_NAME MARKDOWN_VAULT_MCP_STATE_PATH MARKDOWN_VAULT_MCP_INDEX_PATH MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH MARKDOWN_VAULT_MCP_INDEXED_FIELDS MARKDOWN_VAULT_MCP_REQUIRED_FIELDS MARKDOWN_VAULT_MCP_EXCLUDE MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER OPENAI_API_KEY OPENAI_BASE_URL OPENAI_EMBEDDING_MODEL MARKDOWN_VAULT_MCP_OLLAMA_MODEL MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY OLLAMA_HOST MARKDOWN_VAULT_MCP_GIT_TOKEN MARKDOWN_VAULT_MCP_GIT_REPO_URL MARKDOWN_VAULT_MCP_GIT_USERNAME MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S MARKDOWN_VAULT_MCP_GIT_LFS MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER MARKDOWN_VAULT_MCP_PROMPTS_FOLDER MARKDOWN_VAULT_MCP_BEARER_TOKEN MARKDOWN_VAULT_MCP_AUTH_MODE MARKDOWN_VAULT_MCP_BASE_URL MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY MARKDOWN_VAULT_MCP_OIDC_AUDIENCE MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN MARKDOWN_VAULT_MCP_APP_DOMAIN
Claude Code 
claude mcp add --env MARKDOWN_VAULT_MCP_SOURCE_DIR= --env MARKDOWN_VAULT_MCP_READ_ONLY= --env FASTMCP_LOG_LEVEL= --env MARKDOWN_VAULT_MCP_KV_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= --env OPENAI_BASE_URL= --env OPENAI_EMBEDDING_MODEL= --env MARKDOWN_VAULT_MCP_OLLAMA_MODEL= --env MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY= --env OLLAMA_HOST= --env MARKDOWN_VAULT_MCP_GIT_TOKEN= --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= --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= --env MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY= --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= markdown-vault-mcp -- uvx markdown-vault-mcp
Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code 
code --add-mcp '{"name":"markdown-vault-mcp","command":"uvx","args":["markdown-vault-mcp"],"env":{"MARKDOWN_VAULT_MCP_SOURCE_DIR":"","MARKDOWN_VAULT_MCP_READ_ONLY":"","FASTMCP_LOG_LEVEL":"","MARKDOWN_VAULT_MCP_KV_STORE_URL":"","MARKDOWN_VAULT_MCP_SERVER_NAME":"","MARKDOWN_VAULT_MCP_STATE_PATH":"","MARKDOWN_VAULT_MCP_INDEX_PATH":"","MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH":"","MARKDOWN_VAULT_MCP_INDEXED_FIELDS":"","MARKDOWN_VAULT_MCP_REQUIRED_FIELDS":"","MARKDOWN_VAULT_MCP_EXCLUDE":"","MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER":"","OPENAI_API_KEY":"","OPENAI_BASE_URL":"","OPENAI_EMBEDDING_MODEL":"","MARKDOWN_VAULT_MCP_OLLAMA_MODEL":"","MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY":"","OLLAMA_HOST":"","MARKDOWN_VAULT_MCP_GIT_TOKEN":"","MARKDOWN_VAULT_MCP_GIT_REPO_URL":"","MARKDOWN_VAULT_MCP_GIT_USERNAME":"","MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME":"","MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL":"","MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S":"","MARKDOWN_VAULT_MCP_GIT_LFS":"","MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S":"","MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS":"","MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB":"","MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER":"","MARKDOWN_VAULT_MCP_PROMPTS_FOLDER":"","MARKDOWN_VAULT_MCP_BEARER_TOKEN":"","MARKDOWN_VAULT_MCP_AUTH_MODE":"","MARKDOWN_VAULT_MCP_BASE_URL":"","MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL":"","MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID":"","MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET":"","MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY":"","MARKDOWN_VAULT_MCP_OIDC_AUDIENCE":"","MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES":"","MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN":"","MARKDOWN_VAULT_MCP_APP_DOMAIN":""}}'
JSON 
{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "",
        "FASTMCP_LOG_LEVEL": "",
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "",
        "OPENAI_API_KEY": "",
        "OPENAI_BASE_URL": "",
        "OPENAI_EMBEDDING_MODEL": "",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "",
        "OLLAMA_HOST": "",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "",
        "MARKDOWN_VAULT_MCP_BEARER_TOKEN": "",
        "MARKDOWN_VAULT_MCP_AUTH_MODE": "",
        "MARKDOWN_VAULT_MCP_BASE_URL": "",
        "MARKDOWN_VAULT_MCP_OIDC_CONFIG_URL": "",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_ID": "",
        "MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET": "",
        "MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY": "",
        "MARKDOWN_VAULT_MCP_OIDC_AUDIENCE": "",
        "MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPES": "",
        "MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKEN": "",
        "MARKDOWN_VAULT_MCP_APP_DOMAIN": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.