notes-vault-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| S3_BUCKET | No | Bucket holding the vault. | |
| S3_PREFIX | No | Key prefix inside the bucket. Optional. | |
| S3_REGION | No | Region, default us-east-1. | us-east-1 |
| VAULT_PATH | No | Directory holding the vault. Selects the local backend. | |
| S3_ENDPOINT | No | Endpoint URL, e.g. https://minio.example.com. | |
| VAULT_TOKEN | No | Bearer token. Required by --transport http. | |
| VAULT_SCHEMA | No | Local path to a schema file, overriding the one in the vault. | |
| S3_ACCESS_KEY | No | Access key. | |
| S3_SECRET_KEY | No | Secret key. | |
| VAULT_CACHE_DIR | No | Where the index lives, default ~/.cache/notes-vault-mcp. | |
| VAULT_STOP_HOOK | No | Set 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 |
| write_fileA | WRITE — validates the frontmatter against the vault schema and refuses the write if it does not hold. Stamps |
| append_fileA | WRITE — appends to a note and bumps |
| move_fileA | WRITE — moves or renames a note. Use |
| delete_fileA | WRITE — deletes a note for good. Prefer |
| list_filesA | CHEAP — paths only, no metadata and no bodies. |
| 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 |
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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