Skip to content
mcp/harbor
Cursor

Markdown Vault MCP for Cursor

io.github.pvliesdonk/markdown-vault-mcp

Generic markdown vault MCP with hybrid search

client:Cursor transport:stdio runtime:pypi

Install Markdown Vault MCP in Cursor

~/.cursor/mcp.json · windows: %USERPROFILE%\.cursor\mcp.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "markdown-vault-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "markdown-vault-mcp"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "<MARKDOWN_VAULT_MCP_KV_STORE_URL>",
        "MARKDOWN_VAULT_MCP_TOOLS_ALLOW": "<MARKDOWN_VAULT_MCP_TOOLS_ALLOW>",
        "MARKDOWN_VAULT_MCP_TOOLS_DENY": "<MARKDOWN_VAULT_MCP_TOOLS_DENY>",
        "MARKDOWN_VAULT_MCP_SERVER_NAME": "<MARKDOWN_VAULT_MCP_SERVER_NAME>",
        "MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION": "<MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTION>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRA>",
        "MARKDOWN_VAULT_MCP_INSTRUCTIONS": "<MARKDOWN_VAULT_MCP_INSTRUCTIONS>",
        "FASTMCP_LOG_LEVEL": "<FASTMCP_LOG_LEVEL>",
        "FASTMCP_ENABLE_RICH_LOGGING": "<FASTMCP_ENABLE_RICH_LOGGING>",
        "OLLAMA_HOST": "<OLLAMA_HOST>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "VOYAGE_API_KEY": "<VOYAGE_API_KEY>",
        "OPENAI_BASE_URL": "<OPENAI_BASE_URL>",
        "OPENAI_EMBEDDING_MODEL": "<OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "<MARKDOWN_VAULT_MCP_SOURCE_DIR>",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "<MARKDOWN_VAULT_MCP_READ_ONLY>",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "<MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING>",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "<MARKDOWN_VAULT_MCP_DISABLE_APPS_UI>",
        "MARKDOWN_VAULT_MCP_INDEX_PATH": "<MARKDOWN_VAULT_MCP_INDEX_PATH>",
        "MARKDOWN_VAULT_MCP_STATE_PATH": "<MARKDOWN_VAULT_MCP_STATE_PATH>",
        "MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH": "<MARKDOWN_VAULT_MCP_EMBEDDINGS_PATH>",
        "MARKDOWN_VAULT_MCP_INDEXED_FIELDS": "<MARKDOWN_VAULT_MCP_INDEXED_FIELDS>",
        "MARKDOWN_VAULT_MCP_REQUIRED_FIELDS": "<MARKDOWN_VAULT_MCP_REQUIRED_FIELDS>",
        "MARKDOWN_VAULT_MCP_EXCLUDE": "<MARKDOWN_VAULT_MCP_EXCLUDE>",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "<MARKDOWN_VAULT_MCP_TITLE_FIELD>",
        "MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS": "<MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDS>",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "<MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER>",
        "MARKDOWN_VAULT_MCP_PROMPTS_FOLDER": "<MARKDOWN_VAULT_MCP_PROMPTS_FOLDER>",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "<MARKDOWN_VAULT_MCP_CONVENTIONS_FILE>",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "<MARKDOWN_VAULT_MCP_OKF_MODE>",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "<MARKDOWN_VAULT_MCP_OKF_WRITE>",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "<MARKDOWN_VAULT_MCP_OKF_VERIFY>",
        "MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS": "<MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONS>",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "<MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB>",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "<MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES>",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "<MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE>",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "<MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE>",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "<MARKDOWN_VAULT_MCP_SNIPPET_WORDS>",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "<MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS>",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS": "<MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARS>",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "<MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS>",
        "MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS": "<MARKDOWN_VAULT_MCP_FOLDER_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_FTS_WEIGHTS": "<MARKDOWN_VAULT_MCP_FTS_WEIGHTS>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER": "<MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER>",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "<MARKDOWN_VAULT_MCP_OLLAMA_MODEL>",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "<MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY>",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "<MARKDOWN_VAULT_MCP_VOYAGE_MODEL>",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "<MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "<MARKDOWN_VAULT_MCP_FASTEMBED_MODEL>",
        "MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR": "<MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIR>",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "<MARKDOWN_VAULT_MCP_EMBED_CONTEXT>",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "<MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S>",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "<MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE>",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "<MARKDOWN_VAULT_MCP_GIT_TOKEN>",
        "MARKDOWN_VAULT_MCP_GIT_REPO_URL": "<MARKDOWN_VAULT_MCP_GIT_REPO_URL>",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "<MARKDOWN_VAULT_MCP_GIT_USERNAME>",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "<MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S>",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "<MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM": "<MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIM>",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "<MARKDOWN_VAULT_MCP_GIT_LFS>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "<MARKDOWN_VAULT_MCP_FILE_WATCHER>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S>",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "<MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR>",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "<MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN>",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "<MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER": "<MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDER>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "<MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "<MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS>",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "<MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "<MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "<MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "<MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S>",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "<MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES>",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "<MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S>",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "<MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S>",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "<MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT>"
      }
    }
  }
}

Use .cursor/mcp.json in a project root instead to scope it to that project. Cursor merges both. Cursor docs

Markdown Vault MCP in other clients

Markdown Vault MCP MCP server