Notes Vault
Markdown memory vault for coding agents, with schema-checked writes and git ties
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.13.0
- Listing updated
- today
Similar MCP servers
About Notes Vault
Notes Vault is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
The package installs mindin, a memory layer that keeps notes as plain markdown in a folder, an S3 or MinIO bucket, or a vault server. A schema sets required fields, legal statuses and kinds and a tag vocabulary, and any write that breaks it is refused. Starting layouts include PARA, a simple vault and a journal.
Notes can name the code paths they describe, so a session-start hook prints commits newer than the note, and a stop hook asks the agent to save unlogged work. A SQLite index cached under VAULT_CACHE_DIR backs search with stemming, folded diacritics, synonyms and optional on-machine semantic search. Lifecycle commands include close, backlog_add, log_append and lint.
The installer offers to add the vault to Claude Code, Codex and Cursor, changing nothing without a yes. A Docker Compose vault server adds passkey, email-link or GitHub sign-in, shared vaults and a team wiki for people at one email domain, and a guard refuses secrets. Anonymous usage signals are sent only after you opt in. MIT licensed.
Install
Run in a terminal
claude mcp add notes-vault-mcp --env S3_ACCESS_KEY='<S3_ACCESS_KEY>' --env S3_SECRET_KEY='<S3_SECRET_KEY>' -- uvx notes-vault-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"notes-vault-mcp": {
"command": "uvx",
"args": [
"notes-vault-mcp"
],
"env": {
"S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
"S3_SECRET_KEY": "<S3_SECRET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"notes-vault-mcp": {
"command": "uvx",
"args": [
"notes-vault-mcp"
],
"env": {
"S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
"S3_SECRET_KEY": "<S3_SECRET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"notes-vault-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"notes-vault-mcp"
],
"env": {
"S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
"S3_SECRET_KEY": "<S3_SECRET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"notes-vault-mcp": {
"command": "uvx",
"args": [
"notes-vault-mcp"
],
"env": {
"S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
"S3_SECRET_KEY": "<S3_SECRET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"notes-vault-mcp": {
"command": "uvx",
"args": [
"notes-vault-mcp"
],
"env": {
"S3_ACCESS_KEY": "<S3_ACCESS_KEY>",
"S3_SECRET_KEY": "<S3_SECRET_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
VAULT_PATHDirectory holding the vault. Set this or the four S3_* variables.S3_ENDPOINTS3 or MinIO endpoint URL holding the vaultS3_ACCESS_KEYAccess key for the vault bucketS3_SECRET_KEYSecret key for the vault bucketS3_BUCKETBucket holding the vaultS3_PREFIXKey prefix inside the bucketS3_REGIONRegion for the vault bucketVAULT_CACHE_DIRWhere the SQLite index livesVAULT_SCHEMALocal schema file overriding the one in the vaultVAULT_STOP_HOOKSet to off to disable the stop hookVAULT_STOP_HOOK_COMMITSSet to off to turn off the stop hook's unlogged-commit and stale-note checks aloneVAULT_STOP_HOOK_PROMPTSMessages the user writes after the agent's last vault write before the stop hook asks it to save them (default 3), or off
What it does
- Schema-checked writes
- Rejects notes missing required fields or using illegal statuses, kinds or tags.
- Indexed multilingual search
- Uses stemming, folded diacritics and synonyms, with optional local semantic search.
- Session hooks
- Prints commits newer than a note at start and prompts to save unlogged work at stop.
- Flexible storage
- Keeps the vault in a folder, S3 bucket or vault server.
- Team wiki
- Lets people at one email domain share an organisation vault, with a secrets guard.
- Vault migration
- Copies a vault between folder, bucket and server and verifies each file.
Good for
- Give a coding agent memory that survives between sessions
- Keep project decisions tied to the code paths they describe
- Share a team knowledge wiki searchable from Claude
- Archive finished work and track deferred backlog items
Pricing
Open source
MIT licence; self-hosted
Notes Vault FAQ
Where are my notes stored?
As plain markdown in a folder, an S3 or MinIO bucket, or a vault server you run.
Which agents can use it?
The installer can add the vault to Claude Code, Codex and Cursor, and a server vault works with claude.ai.
Does it collect data?
Only anonymous usage signals, and only after you say yes.
What licence is it under?
MIT.
Is Notes Vault free?
Yes. Notes Vault is open source, so you can use and self-host it for free.
How do I add Notes Vault to Claude Code?
Run this command in your terminal: claude mcp add notes-vault-mcp --env S3_ACCESS_KEY='<S3_ACCESS_KEY>' --env S3_SECRET_KEY='<S3_SECRET_KEY>' -- uvx notes-vault-mcp
What are the best alternatives to Notes Vault?
The closest alternatives to Notes Vault are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


