Skip to main content
Glama
gronare

notes-vault-mcp

by gronare

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
S3_BUCKETNoBucket holding the vault.
S3_PREFIXNoKey prefix inside the bucket. Optional.
S3_REGIONNoRegion, default us-east-1.us-east-1
VAULT_PATHNoDirectory holding the vault. Selects the local backend.
S3_ENDPOINTNoEndpoint URL, e.g. https://minio.example.com.
VAULT_TOKENNoBearer token. Required by --transport http.
VAULT_SCHEMANoLocal path to a schema file, overriding the one in the vault.
S3_ACCESS_KEYNoAccess key.
S3_SECRET_KEYNoSecret key.
VAULT_CACHE_DIRNoWhere the index lives, default ~/.cache/notes-vault-mcp.
VAULT_STOP_HOOKNoSet to 'off' to disable the stop hook.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
searchA

CHEAP — start here. Full-text search over the local SQLite index of the vault; it never downloads the whole vault. Matches title, summary, tags and body, folds diacritics, expands synonyms and accepts "quoted phrases". A bare commit sha looks up the notes that mention it. Excludes the archive and superseded notes unless you ask for them, and reports how many it hid.

read_fileA

MODERATE — one round trip to storage. Returns the note with an etag: first line; pass that etag back to write_file to refuse a write over someone else's change. Search first.

write_fileA

WRITE — validates the frontmatter against the vault schema and refuses the write if it does not hold. Stamps updated with today and fills date when missing. Pass expected_etag from read_file to make the write conditional.

append_fileA

WRITE — appends to a note and bumps updated. Creates the note when it is missing.

move_fileA

WRITE — moves or renames a note. Use close to archive finished work.

delete_fileA

WRITE — deletes a note for good. Prefer close, which keeps it.

list_filesA

CHEAP — paths only, no metadata and no bodies. search answers context questions better.

closeA

WRITE — finishes a note: sets status complete (or superseded with superseded_by when merged_into is given) and moves it into the archive. Run it in the same pass as the last commit of the work; a note left open is what makes the vault drift.

log_appendA

WRITE — appends one dated line to the repo log, with the commits it produced. Run once at the end of a session per repo. Creates the log note when it is missing.

contextA

CHEAP — the session-start call. Returns the system notes covering the code at path, the open tasks for it, the reference notes and the tail of the repo log, in one answer. Use it before searching blind.

lintA

MODERATE — reads every note to report drift: broken frontmatter, missing required fields, missing area, unresolved wikilinks, orphans, stale open tasks, archived notes still marked active, duplicate stems and superseded targets that do not exist.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gronare/notes-vault-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server