Notes Vault runs on your own machine — the client starts it, so there is no endpoint to ping. 2 458 installs a week from pypi. Last commit 11 Sep 2026.
Indexed search, schema-checked writes and session hooks for a markdown notes vault
What the code does
We read the source, 22 h ago · rules 3dff92dd89df
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
done = subprocess.run(
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add notes-vault-mcp -- uvx notes-vault-mcp{
"mcpServers": {
"notes-vault-mcp": {
"args": [
"notes-vault-mcp"
],
"command": "uvx"
}
}
}[mcp_servers.notes-vault-mcp]
command = "uvx"
args = ["notes-vault-mcp"]{
"mcpServers": {
"notes-vault-mcp": {
"args": [
"notes-vault-mcp"
],
"command": "uvx"
}
}
}{
"mcpServers": {
"notes-vault-mcp": {
"args": [
"notes-vault-mcp"
],
"command": "uvx"
}
}
}This one needs environment variables set before it will start:
VAULT_PATH (Directory holding the vault. Set this or the four S3_* variables.), S3_ENDPOINT (S3 or MinIO endpoint URL holding the vault), S3_ACCESS_KEY (Access key for the vault bucket), S3_SECRET_KEY (Secret key for the vault bucket), S3_BUCKET (Bucket holding the vault), S3_PREFIX (Key prefix inside the bucket), S3_REGION (Region for the vault bucket), VAULT_CACHE_DIR (Where the SQLite index lives), VAULT_SCHEMA (Local schema file overriding the one in the vault), VAULT_TOKEN (Bearer token required by the streamable HTTP transport), VAULT_STOP_HOOK (Set to off to disable the stop hook).
The author declared them in the registry entry; get the values from the project itself.
Alternatives to Notes Vault
same job, measured the same waySearch indexed websites, read raw page markdown, and score AI visibility for any site.
Local-first second brain with semantic search. Markdown notes indexed by a local ML model.
Git-backed markdown memory for AI agents; search hides superseded and archived notes.
Notion MCP server — search, export, and import pages as markdown
Find where your notes disagree — contradiction detection for markdown vaults.
Read-only MCP for the Eco game wiki: search, Markdown pages, and wiki_* lookups. No keys, no writes.
Semantic search and pattern discovery for Obsidian and markdown vaults.
Web search and URL-to-markdown for agents. Pay per call in USDC on Base, no signup.
Notes Vault — questions
Answers built from our own checks of this server.