Notes Vault runs on your own machine — the client starts it, so there is no endpoint to ping. 4 046 installs a week from pypi. Last commit 2 Nov 2026.
Indexed search, schema-checked writes and session hooks for a markdown notes vault
What the code does
We read the source, 23 h ago · rules 995398eba69f
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": {
"command": "uvx",
"args": [
"notes-vault-mcp"
]
}
}
}[mcp_servers.notes-vault-mcp]
command = "uvx"
args = ["notes-vault-mcp"]{
"mcpServers": {
"notes-vault-mcp": {
"command": "uvx",
"args": [
"notes-vault-mcp"
]
}
}
}{
"servers": {
"notes-vault-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"notes-vault-mcp"
]
}
}
}Optional settings from the registry entry, left out of the block above:
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_STOP_HOOK (Set to off to disable the stop hook).
Alternatives to Notes Vault
same job, measured the same wayList, read, search, and edit markdown notes in a local vault directory.
Search 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.
Encrypted Markdown notes and team knowledge base. Search, read and write notes in vaults you allow.
Local semantic and keyword search over the markdown in a repo or notes folder.
Local MCP server for tasks and notes in any Markdown folder or Obsidian vault. No account needed.
Git-backed markdown memory for AI agents; search hides superseded and archived notes.
Claude distils its past sessions into linked Markdown notes on disk and searches them later.
Notes Vault — questions
Answers built from our own checks of this server.