Notes Vault

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/gronare-notes-vault-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

4 read · 9 write · 1 delete · 2 not yet classified

Secrets

3 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• append_file

  WRITE — appends to an existing note and bumps `updated`; the note must still satisfy the schema. A missing note is refused: create it with write_file.

• backlog

  CHEAP — the backlog sorted by priority then age. Filter by area (a stem, or the prefix a family of stems shares) and by priority.

• backlog_add

  WRITE — files an idea as a backlog note in the task folder: title, area (stem or [[stem]]), one line saying what and why, optional priority (urgent, high, medium, low) and source (who said it and when, or a sha). Call it the moment something is deferred, in so many words or in passing; picking the idea up later is setting its status to active.

• close

  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.

• context

  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.

• delete_file

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

• init

  WRITE — sets a vault up: writes `.vault/schema.yml` and the Obsidian Bases views into the vault root and keeps whatever already exists; force overwrites them, the schema included. Run once per vault, right after installing.

• lint

  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.

• list_files

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

• log_append

  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. repo is the main checkout's name, also from a worktree; branch is the branch the commits were made on. area is the stem of the system note (or [[stem]]); it defaults to the repo name.

• move_file

  WRITE — moves or renames a note; the note must satisfy the schema at the destination. Use `close` to archive finished work.

• obsidian_access

  WRITE — mints the personal token Obsidian's Remotely Save plugin uses to reach this vault over WebDAV, and shows it once. Issuing a new token revokes the previous one. The username is the email on your identity.

• read_file

  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.

• search

  CHEAP — start here. Full-text search over the local SQLite index of the vault; it never downloads the whole vault. Matches file stem, title, summary, tags and body, folds diacritics, expands synonyms and accepts "quoted phrases". A bare commit sha looks up the notes that mention it. A query that is exactly a note's stem, or its [[stem]] wikilink, puts that note first wherever it lives. Every term is required; when no note has them all, it returns the notes matching the most terms and says so in the header. Inflected forms match through stemming in the vault's languages. Search in the vault's l…

• set_status

  WRITE — changes a note's status without rewriting it: backlog (with a priority: urgent, high, medium, low) parks it, active picks it up again, draft. The triage list at session start is settled with this, append_file or close.

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

607

Last commit

Oct 23, 2026 (7 days ago)

Last release

Oct 23, 2026 (7 days ago)

Last package publish

Oct 23, 2026 (7 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.gronare/notes-vault-mcp

Version

0.8.0

Auth

API key

Packages

pypi notes-vault-mcp

License

MIT

Repository

github.com/gronare/notes-vault-mcp

Website

github.com/gronare/notes-vault-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql