AgentSidekick

Markdown Vault MCP

MCP serverby pvliesdonkSRC

Generic markdown vault MCP with hybrid search

SRC Publisher-stated: these are the publisher's own words, not an assessment.

WebsiteRepositorySource listing

Key facts

Type
MCP server · mcp-localSRC
Publisher
pvliesdonk · individualSRC
Licence
MITSRC
Open source
YesDER
Hosting
Local (runs on your machine)SRC
Latest version
6.1.4SRC
Languages
pythonSRC
First published
SRC
In this catalogue since
DER
Last verified
Not verified by a researcher. Last seen in a source on 2026-11-21.

Capabilities and categories

Assigned by keyword rules from the description unless marked otherwise. The matched word is shown so you can judge the match.

CapabilityEvidenceKind
Embeddingsmatched embeddingsDER
Knowledge Bases & Wikismatched knowledge baseDER
Note-takingmatched obsidianDER
Obsidian Vaultsmatched markdown vaultDER
Personal Knowledge Managementmatched obsidianDER
Semantic Searchmatched semantic searchDER
Similarity Searchmatched hybrid searchDER

Filed underData & KnowledgeProductivity & CollaborationNotes & DocumentsResearch & KnowledgeRetrieval & RAGRetrieval-Augmented GenerationVector Databases

Integrations DER

No third-party service is named in the description or package metadata.

Platform compatibility

No pairing has been tested by AgentSidekick. Each status says what kind of evidence exists, not whether it works for you.

Protocol-level29

Each platform listed officially documents support for MCP. This specific pairing has not been tested.

Platform discontinued1
PlatformBasis
Roo CodeDiscontinuedRoo Code documented support for MCP but is discontinued. Project shut down and repository archived.
Unknown17
PlatformBasis
OpenClawCould not confirm whether OpenClaw supports MCP.
OpenHandsOpenHands documents MCP support, but it runs only on web, api, slack surfaces and this server runs locally as a process on your machine. Whether OpenHands can reach a local server is not established.
AiderCould not confirm whether Aider supports MCP.
Bolt (bolt.new)Bolt (bolt.new) documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Bolt (bolt.new) can reach a local server is not established.
Amazon Q DeveloperWinding downCould not confirm whether Amazon Q Developer supports MCP.
Amazon Bedrock Agents (Agents Classic)Maintenance onlyCould not confirm whether Amazon Bedrock Agents (Agents Classic) supports MCP.
GPTs (custom GPTs)Winding downCould not confirm whether GPTs (custom GPTs) supports MCP.
Gemini (app)Gemini (app) documents MCP support, but it runs only on web, mobile surfaces and this server runs locally as a process on your machine. Whether Gemini (app) can reach a local server is not established.
Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder)Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) can reach a local server is not established.
GitHub Copilot ExtensionsDiscontinuedCould not confirm whether GitHub Copilot Extensions supports MCP.
Google AI StudioCould not confirm whether Google AI Studio supports MCP.
JulesWinding downCould not confirm whether Jules supports MCP.
Microsoft CopilotCould not confirm whether Microsoft Copilot supports MCP.
Microsoft Copilot StudioMicrosoft Copilot Studio documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Microsoft Copilot Studio can reach a local server is not established.
Replit AgentReplit Agent documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Replit Agent can reach a local server is not established.
Sourcegraph CodyCould not confirm whether Sourcegraph Cody supports MCP.
v0v0 documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether v0 can reach a local server is not established.

Install

Read from registry metadata. Follow the publisher's instructions; we have not run this.

Packages
RegistryPackageTransportRuntime
ocighcr.io/pvliesdonk/markdown-vault-mcp:v6.1.4streamable-httpnot stated
pypimarkdown-vault-mcpstdiouvx

Environment variables SRC

NameRequiredSecretPublisher's description
MARKDOWN_VAULT_MCP_SHUTDOWN_GRACE_SNoNoSeconds SIGTERM may spend draining in-flight requests before the HTTP server exits. Keep it at or below the termination grace period the orchestrator allows. `0` drops in-flight requests immediately.
MARKDOWN_VAULT_MCP_BASE_URLNoNoPublic base URL of the deployed server, for example `https://mcp.example.com`. Required for OIDC. Also the fallback source of the MCP Apps domain when `app_domain` is unset.
MARKDOWN_VAULT_MCP_BEARER_TOKENNoSecretSingle shared bearer token; enables bearer auth unless `bearer_tokens_file` is set, which takes precedence.
MARKDOWN_VAULT_MCP_OIDC_CONFIG_URLNoNoOIDC discovery document URL, for example `https://auth.example.com/.well-known/openid-configuration`.
MARKDOWN_VAULT_MCP_OIDC_CLIENT_IDNoNoOIDC client identifier registered with the provider.
MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRETNoSecretOIDC client secret registered with the provider.
MARKDOWN_VAULT_MCP_OIDC_AUDIENCENoNoExpected `aud` claim; tokens issued for another audience are rejected.
MARKDOWN_VAULT_MCP_OIDC_REQUIRED_SCOPESNoNoScopes a caller must present, space- or comma-separated. Defaults to `openid` in oidc-proxy mode.
MARKDOWN_VAULT_MCP_OIDC_ADVERTISED_SCOPESNoNoScopes advertised to MCP clients in protected-resource metadata, space- or comma-separated. Overrides the default `openid offline_access`; `oidc_required_scopes` is always added on top. Set this when the registered client is not permitted `offline_access`, or to have clients request extra claim scopes (such as `groups`) without also requiring them in every token.
MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEYNoSecretSigning key for issued tokens; used in oidc-proxy mode only. When unset, the key is derived deterministically from `oidc_client_secret`, so tokens survive a restart. Rotating that secret then invalidates every issued token. Set this explicitly to decouple token validity from secret rotation. Generate with `openssl rand -hex 32`.
MARKDOWN_VAULT_MCP_OIDC_VERIFY_ACCESS_TOKENNoNoValidate the access token instead of the id token.
MARKDOWN_VAULT_MCP_KV_STORE_URLNoNoPersistent-state backend URL shared by every pvl-core subsystem that needs state. `memory://` is in-process and lost on restart; `file:///path` persists on one server; `redis://`, `dynamodb://` and `mongodb://` each need their matching extra. When unset, defaults to `file:///data/state` (the volume family Docker images mount), or to `memory://` (with a warning) on a host where that directory is not usable.
MARKDOWN_VAULT_MCP_APP_DOMAINNoNoMCP Apps iframe domain, used for CSP sandboxing. Overrides the host derived from `base_url`.
MARKDOWN_VAULT_MCP_TOOLS_ALLOWNoNoComma-separated explicit tool names this instance exposes; every other tool is hidden from listings and cannot be invoked. Names matching no registered tool are inert. Mutually exclusive with `tools_deny`. Takes effect through `apply_tool_visibility`.
MARKDOWN_VAULT_MCP_TOOLS_DENYNoNoComma-separated explicit tool names hidden from this instance (absent from listings, cannot be invoked). Names matching no registered tool are inert. Mutually exclusive with `tools_allow`. Takes effect through `apply_tool_visibility`.
MARKDOWN_VAULT_MCP_AUTH_MODENoNoExplicit auth-mode override, accepting `remote` or `oidc-proxy` (case- and whitespace-insensitive). When unset the mode is auto-detected from which auth variables are set; the override exists because having all four OIDC variables set is ambiguous between those two modes. Other values are ignored with a warning.
MARKDOWN_VAULT_MCP_BEARER_TOKENS_FILENoNoPath to a TOML file mapping bearer tokens to subjects; overrides the single-token `bearer_token` mode.
MARKDOWN_VAULT_MCP_BEARER_DEFAULT_SUBJECTNoNoSubject assigned to the single-token bearer mode; ignored when `bearer_tokens_file` is set, since mapped mode carries per-token subjects.
MARKDOWN_VAULT_MCP_SERVER_NAMENoNoRename this server instance; defaults to the project name.
MARKDOWN_VAULT_MCP_INSTANCE_DESCRIPTIONNoNoConcise routing context that distinguishes this deployment's material or responsibility.
MARKDOWN_VAULT_MCP_INSTRUCTIONS_EXTRANoNoDeployment-specific behavioral policy added to the generated MCP instructions.
MARKDOWN_VAULT_MCP_INSTRUCTIONSNoNoLegacy: replaces all generated MCP instructions (deprecated; use _INSTANCE_DESCRIPTION for routing and _INSTRUCTIONS_EXTRA for policy).
MARKDOWN_VAULT_MCP_HTTP_PATHNoNoMount path for the MCP endpoint; the health routes derive their prefix from it.
MARKDOWN_VAULT_MCP_HEALTH_DETAILNoNoHow much the unauthenticated /health and /health/ready bodies say: status, standard (adds name, version and per-check verdicts), or full (adds redacted reasons; trusted networks only).
PUIDNoNoRun the server process as this UID; the container entrypoint reassigns ownership of writable paths to match.
PGIDNoNoRun the server process as this GID; pair with PUID to match the owner of a mounted volume.
MARKDOWN_VAULT_MCP_LOG_LEVELNoNoLog level for every logger in the process, FastMCP's included (DEBUG / INFO / WARNING / ERROR / CRITICAL). The -v CLI flag overrides to DEBUG. The unprefixed FASTMCP_LOG_LEVEL still works for one major version and logs a deprecation warning.
MARKDOWN_VAULT_MCP_LOG_FORMATNoNoLog rendering. rich is one colour event key=value line per record, for a terminal; json is one JSON object per record, for a collector. Unset picks rich when stderr is a terminal and json everywhere else, so a container or journald gets JSON with no configuration.
OLLAMA_HOSTNoNoOllama server URL for the ollama embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the Ollama ecosystem convention.
OPENAI_API_KEYNoSecretOpenAI API key for the openai embedding provider, and the fallback key for the summarize tool when MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY is unset. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OpenAI ecosystem convention.
VOYAGE_API_KEYNoSecretVoyage AI API key for the voyage embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the OPENAI_API_KEY / OLLAMA_HOST convention. Setting it never auto-selects the provider; choose it explicitly with MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDER=voyage.
OPENAI_BASE_URLNoNoBare fallback for MARKDOWN_VAULT_MCP_OPENAI_BASE_URL (embeddings). For the summarize tool it only routes traffic when an API key already enables the feature; it never enables summarize by itself.
OPENAI_EMBEDDING_MODELNoNoBare fallback for MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL.
MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_SNoNoMaximum seconds an index-backed tool or resource waits for the FTS index to become queryable during a cold-start background build before raising IndexUnavailableError(reason="timeout"). Increase for large vaults.
MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_SNoNoMaximum seconds an index-querying read tool waits for the IndexWriter to drain when called with wait_for_pending_writes=true. On timeout the tool answers from the current index and reports index_stale=true in the response _meta.
MARKDOWN_VAULT_MCP_SERVER_URLNoNoHosted MCP endpoint for CLI reads. The explicit server option overrides it. Local mode bypasses it.
MARKDOWN_VAULT_MCP_CLIENT_CONFIGNoNoClient TOML profile path; defaults to XDG_CONFIG_HOME/markdown-vault-mcp/client.toml.
MARKDOWN_VAULT_MCP_CLIENT_TOKENNoSecretOptional CLI bearer token. A nonempty value overrides the profile-selected token environment source; an empty value leaves that source in effect. Never stored in client TOML.
MARKDOWN_VAULT_MCP_SOURCE_DIRNoNoPath to the markdown vault directory. When it does not exist, or the server cannot access it, the server starts but every tool fails with a message saying which until it is fixed (managed git mode clones into it). Symbolic links inside the vault are followed on Python 3.13+.
MARKDOWN_VAULT_MCP_READ_ONLYNoNoSet to true to hide the write tools (write, edit, append, delete, rename, move_folder, fetch, git_sync, the okf_* tools, create_upload_link) and serve a search-only vault.
MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTINGNoNoRefuse a write that would overwrite an existing file when no if_match etag is supplied. Deliberate replacement still works: read the file first, then pass if_match. Unaffected: edit, append, delete, rename. Set to false to allow blind overwrites.
MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKSNoNoSet to true to have write, edit and append list, under unresolved_links, the target of each link the call added that get_broken_links reports. Links the note already held are left out. Off by default, leaving those responses unchanged.
MARKDOWN_VAULT_MCP_DISABLE_APPS_UINoNoHide the MCP Apps UI tools (browse_vault, show_context) from the tool listing for clients that do not render MCP Apps panels.
MARKDOWN_VAULT_MCP_INDEX_PATHNoNoPath to the SQLite FTS5 index file; unset keeps the index in memory. Set it for persistence across restarts.
MARKDOWN_VAULT_MCP_STATE_PATHNoNoPath to the change-tracking state file. Defaults to INDEX_PATH plus .state.json (index.db.state.json beside index.db); without INDEX_PATH the state is kept in memory. Never written into the vault by default.
MARKDOWN_VAULT_MCP_EMBEDDINGS_PATHNoNoBase path for the embeddings files. Defaults beside INDEX_PATH (index-db-embeddings.sqlite3 beside index.db, or index-db-embeddings.v2.json and the matrix it names with EMBEDDING_STORE=numpy; the first build copies in the vectors a release's sidecar there holds, then leaves it alone); without INDEX_PATH the vectors are kept in memory and rebuilt at each start. Setting it also lets the provider be auto-detected.
MARKDOWN_VAULT_MCP_EMBEDDING_STORENoNoWhere embeddings are stored. 'sqlite' (the default) keeps them in one SQLite database beside the index (index-db-embeddings.sqlite3), each change written durably on its own; 'numpy' keeps them in files there and rewrites them all on each save. Without INDEX_PATH or EMBEDDINGS_PATH both keep them in memory. 'postgres' keeps them in a PostgreSQL schema with pgvector (EMBEDDING_POSTGRES_DSN and EMBEDDING_POSTGRES_SCHEMA; the postgres extra).
MARKDOWN_VAULT_MCP_EMBEDDING_SEARCHNoNoHow semantic search reads the embeddings. 'resident' holds them all in memory, the fastest; 'streamed' keeps none in memory and reads them from the store in batches for each search, slower as the vault grows. 'streamed' needs EMBEDDING_STORE=sqlite or postgres, and postgres is always streamed; vectors kept in memory (no INDEX_PATH or EMBEDDINGS_PATH) are always resident. Unset, it is the store's default: 'streamed' with sqlite and postgres, 'resident' with numpy.
MARKDOWN_VAULT_MCP_EMBEDDING_SEARCH_WORKSPACE_MBNoNoWith EMBEDDING_STORE=sqlite and EMBEDDING_SEARCH=streamed, the embeddings one batch of a search may hold, in MiB (at least 1). It bounds the search's working memory, not the process's; postgres scores in the database and does not use it.
MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_DSNNoSecretWith EMBEDDING_STORE=postgres, the libpq connection string or URI of the database holding the embeddings. A secret: never logged or shown. The password may instead come from PGPASSWORD or a .pgpass file.
MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_SCHEMANoNoWith EMBEDDING_STORE=postgres, the schema this vault's embeddings live in: one schema per vault, created by the operator. The vault creates only its own tables there.
MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_POOL_SIZENoNoWith EMBEDDING_STORE=postgres, the most connections the store opens (at least 1).
MARKDOWN_VAULT_MCP_EMBEDDING_POSTGRES_STATEMENT_TIMEOUT_SNoNoWith EMBEDDING_STORE=postgres, the longest one query may run, in seconds (0 sets none; at most 2147483.647). The bulk write of a full rebuild is never limited.
MARKDOWN_VAULT_MCP_INDEXED_FIELDSNoNoComma-separated frontmatter fields promoted to the tag index for structured filtering. Changing it cold-rebuilds the index once on next startup; SEARCHABLE_FIELDS inherits this value when unset.
MARKDOWN_VAULT_MCP_REQUIRED_FIELDSNoNoComma-separated frontmatter fields required on every document; documents missing any are excluded from the index.
MARKDOWN_VAULT_MCP_EXCLUDENoNoComma-separated glob patterns excluded from scanning, e.g. .obsidian/**,.trash/**.
MARKDOWN_VAULT_MCP_TITLE_FIELDNoNoFrontmatter field used as the document title (falls back to title, the first H1, then the filename). Changing it cold-rebuilds the index once on next startup.
MARKDOWN_VAULT_MCP_SEARCHABLE_FIELDSNoNoComma-separated frontmatter fields whose text values become keyword-searchable and enrich first-chunk embeddings. Inherits INDEXED_FIELDS when unset; the sentinel none means filterable but not searchable. Changing it cold-rebuilds the index and re-embeds once on next startup.
MARKDOWN_VAULT_MCP_TEMPLATES_FOLDERNoNoRelative folder where note templates live (used by the create_from_template prompt).
MARKDOWN_VAULT_MCP_PROMPTS_FOLDERNoNoDirectory of .md prompt files that extend or override built-in prompts; a relative path is resolved against SOURCE_DIR.
MARKDOWN_VAULT_MCP_CONVENTIONS_FILENoNoFilename of the per-folder conventions files surfaced to clients at write time (bare .md filename without glob characters). Set to none to disable folder conventions.
MARKDOWN_VAULT_MCP_OKF_MODENoNoOKF (Open Knowledge Format) read semantics. With auto (the default), read annotations switch on when the vault declares an OKF version in its root index.md. Use off to disable OKF semantics entirely, or on to force them for an undeclared vault. Annotations are read-only; write behavior is never affected.
MARKDOWN_VAULT_MCP_OKF_WRITENoNoOKF (Open Knowledge Format) enforced write layer. When true on an OKF-active vault, the server stamps generated provenance on each write and clears any verified attestation when a note's content changes. It also keeps each written folder's log.md and index.md current, and exposes the okf_verify tool. Requires OKF_MODE to be auto or on (a true value with OKF_MODE=off is a config error). Off by default.
MARKDOWN_VAULT_MCP_OKF_VERIFYNoNoHow the okf_verify tool attributes a human review. This applies only when OKF_WRITE is on, which gates the tool. With elicit (the default), okf_verify asks the human to confirm the review through an MCP elicitation, then records the attestation only on an affirmative reply. It fails closed when the client cannot elicit or the human declines, so a model holding the human's token cannot self-attest. Set trust-auth instead to attribute to a token's sub claim with no confirmation; it rejects static bearer credentials, other client-ID-only identities, and OAuth tokens the issuer marks as an application's. This is safe only when the sole caller is a human-driven UI. Set off to hide the tool, leaving attestation to external tooling. A non-default value with OKF_WRITE off is a config error.
MARKDOWN_VAULT_MCP_SERVICE_SUBJECTSNoNoComma-separated token sub values that belong to applications, not people. A caller whose sub is listed is a service: its OKF writes stamp the tool actor instead of human:<sub>, and okf_verify records its review as local (elicit) or refuses it (trust-auth). Entries match the token's sub exactly. Use it for issuers whose client-credentials tokens carry nothing that marks them as an application's, such as a Keycloak, authentik or Zitadel service account; list that account's sub (for Keycloak, the service-account user's ID, not its name).
MARKDOWN_VAULT_MCP_ATTACHMENT_EXTENSIONSNoNoComma-separated allowed attachment extensions (e.g. pdf,png,jpg); case and a leading dot are ignored, so PDF and .pdf name the same type. Use * to allow every non-markdown file. Unset selects the built-in allowlist. A link whose target has a listed extension is not part of the link graph; changing the list rebuilds the index once.
MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MBNoNoMaximum attachment size in MB returned by read / accepted by write; 0 disables the limit.
MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTESNoNoMaximum bytes returned by a full-document read of a note; use `read(path, section=…)` for partial reads. 0 disables the limit.
MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODENoNoMode used when a search call omits 'mode': auto, keyword, semantic, or hybrid. The default 'auto' picks hybrid when embeddings are configured and keyword when they are not. Pin 'keyword' to keep unqualified searches off the embedding provider (each hybrid or semantic search embeds the query, which costs an API call on a metered provider). A configured semantic/hybrid default also degrades to keyword without embeddings, so no setting can make a vault unsearchable; an explicit mode= argument is never downgraded.
MARKDOWN_VAULT_MCP_CHUNKS_PER_FILENoNoMaximum chunks returned per document in search results.
MARKDOWN_VAULT_MCP_SNIPPET_WORDSNoNoWidth of the snippet window (words) in search results; 0 returns full chunk content.
MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHANoNoDown-weights longer chunks in ranking: score / (1 + alpha * log(chunk_count)).
MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDSNoNoWord cap per chunk; the adaptive chunker splits at deeper heading levels, then paragraph/word boundaries, to respect it. Match it to the embedding model's context. A reindex applies a new value.
MARKDOWN_VAULT_MCP_MAX_CHUNK_CHARSNoNoCharacter cap enforced alongside MAX_CHUNK_WORDS to bound token-dense chunks. Unset derives min(1500, model context * 2.8). Set a positive value for an exact cap, or -1 to scale with the model's full context (can exhaust memory on long-context models). A reindex applies a new value.
MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDSNoNoWords of overlap between adjacent budget-split fragments of the same heading section (0 disables). A reindex applies a new value.
MARKDOWN_VAULT_MCP_FOLDER_WEIGHTSNoNoFolder-prefix score multipliers (`prefix:weight` pairs, comma-separated, weights > 0) applied to all search modes; the deepest matching prefix wins (sessions:0.5 demotes sessions/**).
MARKDOWN_VAULT_MCP_FTS_WEIGHTSNoNoPer-column BM25 weights (`column:weight` pairs, comma-separated, weights >= 0) for keyword ranking. Columns: path, title, folder, heading, content, summary.
MARKDOWN_VAULT_MCP_EMBEDDING_PROVIDERNoNoEmbedding provider: openai, voyage, ollama, or fastembed; setting it turns on search by meaning. Unset auto-detects from the environment (never voyage), but only when EMBEDDINGS_PATH is set or EMBEDDING_STORE=postgres. Any OpenAI-compatible endpoint works with openai plus OPENAI_BASE_URL; see the embeddings guide.
MARKDOWN_VAULT_MCP_OLLAMA_MODELNoNoOllama embedding model name.
MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLYNoNoForce Ollama to embed on CPU only.
MARKDOWN_VAULT_MCP_VOYAGE_MODELNoNoVoyage AI embedding model name.
MARKDOWN_VAULT_MCP_OPENAI_BASE_URLNoNoOpenAI-compatible API base URL for embeddings; the bare OPENAI_BASE_URL is honoured as a fallback.
MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODELNoNoOpenAI-compatible embedding model name; the bare OPENAI_EMBEDDING_MODEL is honoured as a fallback.
MARKDOWN_VAULT_MCP_FASTEMBED_MODELNoNoFastEmbed model name.
MARKDOWN_VAULT_MCP_FASTEMBED_CACHE_DIRNoNoFastEmbed model cache directory (in Docker, stored under /data/state/fastembed).
MARKDOWN_VAULT_MCP_EMBED_CONTEXTNoNoEnrich embedding input with the note title, chunk heading, and (first chunk) searchable-field values. Flipping it re-embeds the whole vault once on next startup.
MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_SNoNoPer-request wall-clock budget in seconds for a single embedding HTTP call (OpenAI/Ollama). The local FastEmbed backend runs in-process with no network call and ignores this. CPU-only or large-model workloads may need 60-120 s; raise this if batches time out.
MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZENoNoNumber of chunks sent per embedding request. Smaller batches shorten each request (useful under a tight timeout on slow models) at the cost of more round-trips.
MARKDOWN_VAULT_MCP_GIT_TOKENNoSecretToken/password for HTTPS git auth; remotes must be HTTPS when set.
MARKDOWN_VAULT_MCP_GIT_REPO_URLNoNoHTTPS remote URL for managed git mode: the server clones into an empty SOURCE_DIR on startup (or validates an existing origin) and enables the pull loop, auto-commit, and deferred push.
MARKDOWN_VAULT_MCP_GIT_USERNAMENoNoUsername for HTTPS git auth prompts (x-access-token for GitHub, oauth2 for GitLab, the account name for Bitbucket).
MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_SNoNoSeconds between git fetch + fast-forward update attempts; 0 disables periodic pull.
MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_SNoNoSeconds of write-idle time before pushing; 0 pushes only on shutdown.
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAMENoNoGit committer name for auto-commits, and the author name too unless an OIDC claim supplies one; set this in Docker where git config user.name is empty.
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAILNoNoGit committer email for auto-commits, and the author email too unless an OIDC claim supplies one.
MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME_CLAIMNoNoOIDC claim key used as the commit author name (e.g. name) when an OIDC token is present; the committer stays GIT_COMMIT_NAME. The claim is resolved when the tool call arrives and carried to the background commit, so it applies on every write. A configured claim the token does not carry is reported once at WARNING and the static identity is used.
MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL_CLAIMNoNoOIDC claim key used as the commit author email (e.g. email) when an OIDC token is present; the committer stays GIT_COMMIT_EMAIL. Resolved and carried the same way as the name claim.
MARKDOWN_VAULT_MCP_GIT_LFSNoNoRun git lfs pull on startup to fetch LFS-tracked attachments; set to false for repos without LFS.
MARKDOWN_VAULT_MCP_FILE_WATCHERNoNoWatch the vault for external filesystem changes; auto-disabled when git pull is active or a webhook can deliver (HTTP/SSE transports only). Requires the file-watcher extra.
MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_SNoNoSeconds of quiet after the last filesystem event before reindexing.
MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOORNoNoKeep the non-recursive watch on the vault root; set false to register zero source-dir-rooted FSEvents streams (avoids repeated macOS access prompts on a home-rooted vault) at the cost of root-level files relying on scans.
MARKDOWN_VAULT_MCP_BOOT_REINDEXNoNoReconcile offline changes at startup by reindexing once the initial build completes. Set false on a large vault to start without paying a full filesystem scan per server start; changes made while no server was running are then invisible until a reindex runs (the reindex tool, or 'markdown-vault-mcp admin reindex'). `get_index_status` reports `offline_changes` as `not_reconciled` until the server itself runs one; a reindex from the command line updates the index but not that status. Note that `index_stale` reports writer idleness, not agreement with disk, so it reads false while the index may still differ from the vault.
MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRETNoSecretShared secret for the GitHub push-event webhook; when set, mounts POST /github-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events.
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKENNoSecretSigning token for the GitLab push-event webhook (GitLab 19.0+); when set, mounts POST /gitlab-webhook on HTTP/SSE transports to trigger an immediate pull + reindex on push events. GitLab generates this value; copy the `whsec_` token it shows under Generate signing token rather than inventing one. Deliveries are authenticated by HMAC-SHA256 over the webhook id, timestamp and body, and a delivery older than 5 minutes is rejected.
MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKENNoSecretSecret token for the GitLab push-event webhook, GitLab's plain-text form and the only one below 19.0; also mounts POST /gitlab-webhook. It proves nothing about the body and cannot expire, so prefer the signing token where the GitLab version offers it. Setting both accepts either, which is how an existing webhook migrates.
MARKDOWN_VAULT_MCP_SUMMARIZE_PROVIDERNoNoSummarization backend (only openai is recognised). Unset auto-detects: the backend activates when credentials or an explicit endpoint are present.
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEYNoSecretAPI key for the OpenAI-compatible summarize endpoint; the bare OPENAI_API_KEY is honoured as a fallback. Unset works for keyless local endpoints (Ollama).
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_BASE_URLNoNoOpenAI-compatible endpoint base URL for the summarize tool; setting it enables the tool even without an API key. The bare OPENAI_BASE_URL routes traffic only when a key already enables the feature.
MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODELNoNoChat model id used for summaries.
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENSNoNoUpper bound on generated tokens per summarize call; on reasoning models this budget also covers internal reasoning tokens.
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTESNoNoCap on the number of notes summarised in one call (subtree expansion truncates to this many).
MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARSNoNoAggregate cap on note characters sent to the model in one call; excess is truncated with a flag on the result.
MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUTNoNoPer-request wall-clock budget in seconds for a single summarize backend call; keep it below the MCP client's request timeout so the server-side error wins the race.
MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_SNoNoLink lifetime in seconds when the caller requests no explicit TTL.
MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_SNoNoCeiling in seconds a caller-requested link TTL is clamped to.
MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_SNoNoPost-success grace window in seconds: a served token's TTL shrinks to this so a stalled transfer can retry within it.
MARKDOWN_VAULT_MCP_TRANSFER_LEASE_SNoNoCrashed-handler reclaim window in seconds for an in-flight reservation.
MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTESNoNoMaximum size in bytes of a single upload.
MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_SNoNoSeconds a long-running tool call may run in the foreground before it is promoted to a background job and a job handle is returned instead.
MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_SNoNoSeconds a background-job record (working or finished) is retained for polling before it expires from the store.
MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECTNoNoMaximum live background jobs per calling subject; further promotions are rejected until older records expire.

Permissions and signals

Signals, not a safety verdict. They describe what the product's metadata references. Security review: not reviewed.

SignalEvidenceHow observedObserved
Runs a local processruns locally via pypiregistry metadata 2026-11-21
Asks for a secretdeclares secret env var(s): MARKDOWN_VAULT_MCP_BEARER_TOKEN, MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET, MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY, OPENAI_API_KEY, VOYAGE_API_KEYregistry metadata 2026-11-21

Known advisories for the published package SRC

An advisory existing does not mean the listed version is affected: compare the vulnerable range with the version you install. None found is not evidence of safety.

No advisories found

No published advisory matches a package this product declares. Products without a declared package cannot be matched at all. This is not evidence of safety.

Evaluation

Separate dimensions, each with its evidence. There is no overall score: the dimensions do not add up to one number honestly.

Source authority

Publisher-submitted

Published to the official MCP Registry by the namespace owner. Field values are the publisher's own claims.

Publisher verification

Namespace verified by registry

The MCP Registry verifies namespace ownership (GitHub login or DNS) before publishing. This confirms who published it, not what it does.

Maintenance activity

Active

Last push 2026-11-21 (0 days before this page was built).

Licence clarity

MIT

Licence identifier as reported by GitHub repository metadata.

Installation clarity

Machine-readable

2 package(s) and 0 remote endpoint(s) declared in registry metadata.

Documentation

Repository / website only

No dedicated documentation URL on record. AgentSidekick has not assessed documentation quality.

Compatibility evidence

Protocol-level only

Compatibility is inferred from the standard it implements. No pairing has been tested.

Security review

Not reviewed

AgentSidekick has not audited this product. 2 automated signal(s) are listed under Permissions & signals — they describe what it references, not whether it is safe.

Pricing

Not published in any source we track. The code is open source, which says nothing about the cost of any hosted service.

Repository activity

pvliesdonk/markdown-vault-mcp. Read from the GitHub API on 2026-11-21.

41SRCGitHub stars
18SRCForks
170SRCOpen issues
todaySRCLast push2026-11-21
v6.1.4SRCLatest release2026-11-18

Version history SRC

  1. 6.1.4
  2. 6.1.3
  3. 6.1.2
  4. 6.1.1
  5. 6.1.0
  6. 6.0.0
  7. 5.1.0
  8. 5.0.0
30 earlier versions
  1. 4.2.0
  2. 4.1.0
  3. 4.0.0
  4. 3.1.0
  5. 3.0.4
  6. 3.0.3
  7. 3.0.2
  8. 3.0.1
  9. 3.0.0
  10. 1.27.1
  11. 1.27.0
  12. 1.25.0
  13. 1.23.1
  14. 1.23.0
  15. 1.22.1
  16. 1.22.0
  17. 1.21.0
  18. 1.20.1
  19. 1.20.0
  20. 1.19.1
  21. 1.19.0
  22. 1.18.1
  23. 1.18.0
  24. 1.17.0
  25. 1.16.0
  26. 1.15.0
  27. 1.14.0
  28. 1.13.4
  29. 1.13.3
  30. 1.13.1

Change history

What changed between two ingests of the same source, and when the product was first seen. Registry releases are under Version history.

  1. First seen

Competitors and alternativesDER

Paired by shared capabilities and integrations. Similar on paper; not tested side by side.

Direct

Same type, overlapping capabilities.

Vault Cortex

MCP serverby aliasunderSRC

38 GitHub starspushed 1d agoMIT

SharesSimilarity SearchSemantic SearchKnowledge Bases & WikisPersonal Knowledge Management

Hatchdoor

MCP serverby BatterWorksSRC

77 GitHub starspushed 4d agoAGPL-3.0

SharesSemantic SearchKnowledge Bases & WikisPersonal Knowledge ManagementNote-taking

Enzyme

MCP serverby byenzymeSRC

160 GitHub starspushed 10d agoApache-2.0

SharesSemantic SearchKnowledge Bases & WikisPersonal Knowledge ManagementNote-taking

AutoRAG

MCP serverby Marker-Inc-KoreaHEU

6.1k GitHub starspushed 1d agoApache-2.0

SharesSimilarity SearchSemantic SearchEmbeddingsKnowledge Bases & Wikis

enquire-mcp

MCP serverby oomkapwnSRC

37 GitHub starspushed 6d agoMIT

SharesSimilarity SearchSemantic SearchKnowledge Bases & WikisPersonal Knowledge Management

SharesSemantic SearchEmbeddingsKnowledge Bases & WikisPersonal Knowledge Management

Provenance

Which source set each field, what kind of claim it is, and when.

FieldSourceKindSet on
Canonical URLOfficial MCP RegistrySRC2026-11-21
PublisherOfficial MCP RegistrySRC2026-11-21
DescriptionOfficial MCP RegistrySRC2026-11-21
HostingOfficial MCP RegistrySRC2026-11-21
Integration typeOfficial MCP RegistrySRC2026-11-21
LanguagesGitHub repository metadataSRC2026-11-21
Latest versionOfficial MCP RegistrySRC2026-11-21
LicenceGitHub repository metadataSRC2026-11-21
NameOfficial MCP RegistrySRC2026-11-21
Open sourceGitHub repository metadataDER2026-11-21
TypeOfficial MCP RegistrySRC2026-11-21
PublishedOfficial MCP RegistrySRC2026-11-21
RepositoryOfficial MCP RegistrySRC2026-11-21
source_updated_atOfficial MCP RegistrySRC2026-11-21
Source URLOfficial MCP RegistrySRC2026-11-21
WebsiteOfficial MCP RegistrySRC2026-11-21

Sources

Not verified by a researcher. Last seen in a source on . Report incorrect information

Page data last updated .