Skip to content
MCP server

Notes Vault

Markdown memory vault for coding agents, with schema-checked writes and git ties

Runs locallyStatus and history
Install
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-mcp

Add 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 vault
  • S3_ACCESS_KEYAccess key for the vault bucket
  • S3_SECRET_KEYSecret key for the vault bucket
  • S3_BUCKETBucket holding the vault
  • S3_PREFIXKey prefix inside the bucket
  • S3_REGIONRegion for the vault bucket
  • VAULT_CACHE_DIRWhere the SQLite index lives
  • VAULT_SCHEMALocal schema file overriding the one in the vault
  • VAULT_STOP_HOOKSet to off to disable the stop hook
  • VAULT_STOP_HOOK_COMMITSSet to off to turn off the stop hook's unlogged-commit and stale-note checks alone
  • VAULT_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.

How AIPoweredBot checks servers