SERVER

Notes Vault

Rank #6,876

io.github.gronare/notes-vault-mcp

Indexed search, schema-checked writes and session hooks for a markdown notes vault

17 versions

by gronare (1 servers)View repository ↗Claim this server

First listed

Sep 5, 2026

Last publish date

Sep 11, 2026

OVERVIEW

Notes Vault is a Model Context Protocol (MCP) server published by gronare. It ranks #6,876 of 132,046 servers tracked on MCP Toplist. Notes Vault is listed across 2 registries — Official MCP and Glama, with 17 tracked versions. It was first listed on Sep 5, 2026 and most recently updated on Sep 11, 2026.

STANDING

#6,876of 132,046 tracked serversTop 10%

Ranks ahead of 125,170 of 132,046 servers on MCP Toplist.

CONNECT

Use Notes Vault

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

Python package (PyPI)

claude mcp add notes-vault-mcp -e "VAULT_PATH=<your VAULT_PATH>" -e "S3_ENDPOINT=<your S3_ENDPOINT>" -e "S3_ACCESS_KEY=<your S3_ACCESS_KEY>" -e "S3_SECRET_KEY=<your S3_SECRET_KEY>" -e "S3_BUCKET=<your S3_BUCKET>" -e "S3_PREFIX=<your S3_PREFIX>" -e "S3_REGION=<your S3_REGION>" -e "VAULT_CACHE_DIR=<your VAULT_CACHE_DIR>" -e "VAULT_SCHEMA=<your VAULT_SCHEMA>" -e "VAULT_TOKEN=<your VAULT_TOKEN>" -e "VAULT_STOP_HOOK=<your VAULT_STOP_HOOK>" -- uvx notes-vault-mcp

Replace each placeholder with your own value before saving.

Python package (PyPI)

[mcp_servers.notes-vault-mcp]
command = "uvx"
args = ["notes-vault-mcp"]

[mcp_servers.notes-vault-mcp.env]
VAULT_PATH = "<your VAULT_PATH>"
S3_ENDPOINT = "<your S3_ENDPOINT>"
S3_ACCESS_KEY = "<your S3_ACCESS_KEY>"
S3_SECRET_KEY = "<your S3_SECRET_KEY>"
S3_BUCKET = "<your S3_BUCKET>"
S3_PREFIX = "<your S3_PREFIX>"
S3_REGION = "<your S3_REGION>"
VAULT_CACHE_DIR = "<your VAULT_CACHE_DIR>"
VAULT_SCHEMA = "<your VAULT_SCHEMA>"
VAULT_TOKEN = "<your VAULT_TOKEN>"
VAULT_STOP_HOOK = "<your VAULT_STOP_HOOK>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "notes-vault-mcp": {
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "<your VAULT_PATH>",
        "S3_ENDPOINT": "<your S3_ENDPOINT>",
        "S3_ACCESS_KEY": "<your S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<your S3_SECRET_KEY>",
        "S3_BUCKET": "<your S3_BUCKET>",
        "S3_PREFIX": "<your S3_PREFIX>",
        "S3_REGION": "<your S3_REGION>",
        "VAULT_CACHE_DIR": "<your VAULT_CACHE_DIR>",
        "VAULT_SCHEMA": "<your VAULT_SCHEMA>",
        "VAULT_TOKEN": "<your VAULT_TOKEN>",
        "VAULT_STOP_HOOK": "<your VAULT_STOP_HOOK>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "notes-vault-mcp": {
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "<your VAULT_PATH>",
        "S3_ENDPOINT": "<your S3_ENDPOINT>",
        "S3_ACCESS_KEY": "<your S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<your S3_SECRET_KEY>",
        "S3_BUCKET": "<your S3_BUCKET>",
        "S3_PREFIX": "<your S3_PREFIX>",
        "S3_REGION": "<your S3_REGION>",
        "VAULT_CACHE_DIR": "<your VAULT_CACHE_DIR>",
        "VAULT_SCHEMA": "<your VAULT_SCHEMA>",
        "VAULT_TOKEN": "<your VAULT_TOKEN>",
        "VAULT_STOP_HOOK": "<your VAULT_STOP_HOOK>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "servers": {
    "notes-vault-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "<your VAULT_PATH>",
        "S3_ENDPOINT": "<your S3_ENDPOINT>",
        "S3_ACCESS_KEY": "<your S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<your S3_SECRET_KEY>",
        "S3_BUCKET": "<your S3_BUCKET>",
        "S3_PREFIX": "<your S3_PREFIX>",
        "S3_REGION": "<your S3_REGION>",
        "VAULT_CACHE_DIR": "<your VAULT_CACHE_DIR>",
        "VAULT_SCHEMA": "<your VAULT_SCHEMA>",
        "VAULT_TOKEN": "<your VAULT_TOKEN>",
        "VAULT_STOP_HOOK": "<your VAULT_STOP_HOOK>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "notes-vault-mcp": {
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "<your VAULT_PATH>",
        "S3_ENDPOINT": "<your S3_ENDPOINT>",
        "S3_ACCESS_KEY": "<your S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<your S3_SECRET_KEY>",
        "S3_BUCKET": "<your S3_BUCKET>",
        "S3_PREFIX": "<your S3_PREFIX>",
        "S3_REGION": "<your S3_REGION>",
        "VAULT_CACHE_DIR": "<your VAULT_CACHE_DIR>",
        "VAULT_SCHEMA": "<your VAULT_SCHEMA>",
        "VAULT_TOKEN": "<your VAULT_TOKEN>",
        "VAULT_STOP_HOOK": "<your VAULT_STOP_HOOK>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "notes-vault-mcp": {
      "command": "uvx",
      "args": [
        "notes-vault-mcp"
      ],
      "env": {
        "VAULT_PATH": "<your VAULT_PATH>",
        "S3_ENDPOINT": "<your S3_ENDPOINT>",
        "S3_ACCESS_KEY": "<your S3_ACCESS_KEY>",
        "S3_SECRET_KEY": "<your S3_SECRET_KEY>",
        "S3_BUCKET": "<your S3_BUCKET>",
        "S3_PREFIX": "<your S3_PREFIX>",
        "S3_REGION": "<your S3_REGION>",
        "VAULT_CACHE_DIR": "<your VAULT_CACHE_DIR>",
        "VAULT_SCHEMA": "<your VAULT_SCHEMA>",
        "VAULT_TOKEN": "<your VAULT_TOKEN>",
        "VAULT_STOP_HOOK": "<your VAULT_STOP_HOOK>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.gronare%2Fnotes-vault-mcp.svg)](https://mcptoplist.com/server/io.github.gronare%2Fnotes-vault-mcp)

HTML

<a href="https://mcptoplist.com/server/io.github.gronare%2Fnotes-vault-mcp"><img src="https://mcptoplist.com/badge/io.github.gronare%2Fnotes-vault-mcp.svg" alt="MCP Toplist: Top 10% of 132,046" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 2 registries

Official MCP

Glama

ORGANIZATION

gronare

Organization

gronare

Servers in org

Versions across org

VERSIONS

Available versions (17)

Version	Published
0.4.5	Sep 11, 2026
0.4.4	Sep 11, 2026
0.4.3	Sep 11, 2026
0.4.2	Sep 11, 2026
0.4.1	Sep 11, 2026
0.3.2	Sep 9, 2026
0.4.0	Sep 9, 2026
0.3.1	Sep 9, 2026
0.3.0	Sep 8, 2026
0.2.7	Sep 8, 2026
0.2.6	Sep 6, 2026
0.2.5	Sep 6, 2026
0.2.4	Sep 5, 2026
0.2.3	Sep 5, 2026
0.2.2	Sep 5, 2026
0.2.1	Sep 5, 2026
0.2.0	Sep 5, 2026

FAQ

Frequently asked questions

Who maintains Notes Vault?: Notes Vault is maintained by gronare, which publishes 1 MCP server (17 total versions) tracked on MCP Toplist.
Is Notes Vault listed on the Official MCP Registry?: Yes — Notes Vault is listed on the Official MCP Registry, alongside Glama.
How many versions does Notes Vault have?: MCP Toplist tracks 17 versions of Notes Vault, most recently published on Sep 11, 2026.
Where can I find the source code for Notes Vault?: The source code for Notes Vault is hosted at github.com/gronare/notes-vault-mcp.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers