Hive 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/mlorentedev-hive-vault

About

Use cases: note-taking, knowledge-base

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 and install config. Checked Oct 25, 2026.

Tools

6 read · 5 write · 1 delete · 2 not yet classified

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (14)

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

• capture_lesson

  Capture lessons: inline / batch write, or lookup by keyword. Inline mode (default): provide title, context, problem, solution. Batch mode: provide text to extract lessons automatically via worker. Lookup mode: provide ``find`` to surface top-ranked existing lessons whose heading matches the keyword. Args: project: Project slug (directory under 10_projects/). title: Short descriptive title (inline mode). context: What you were doing (inline mode). problem: What went wrong or what decision was needed (inline mode). solution: What fixed it or what was decided (inline mode). …

• delegate_task

  Offload work to a cheaper model or summarize vault files. When project is provided, reads a vault file. Small files (≤50 lines) are returned directly. Large files are auto-delegated to a worker for summarization — falls back to raw content if workers are unavailable. Args: prompt: The task description or code to process. context: Optional system context for the model. model: Concrete model id. Empty uses the configured worker model. The 4.0.0 removal retired 'auto', 'ollama', 'openrouter-free' and 'openrouter'; passing one is rejected rather than ignored. max_…

• echo

  Return the length + SHA-256 of the received payload (integrity check).

• ping

  Trivial fast call (no shared state).

• record

  Shared-state write: INSERT a row, return the running count. One owning connection + lock = the ADR-004 intra-process model. There is exactly one writer process, so writes serialize on a local lock, not an inter-process filelock — the contention class HIVE-115/116 removed.

• slow

  A slow op modelling hive's git path: blocking work offloaded to a worker thread (``asyncio.to_thread``) so the event loop stays free and other sessions are not head-of-line-blocked.

• vault_ask

  Ask a natural-language question; get a source-cited synthesized answer (semantic retrieval / RAG) or relevant vault sections when no synthesis model is configured. OPTIONAL — disabled by default. Requires the `[semantic]` extra plus an embeddings backend (`HIVE_EMBED_BASE_URL`); until then it returns a short how-to-enable message and never errors. Set `HIVE_SYNTH_MODEL` to enable LLM synthesis on top of retrieval. For keyword / regex lookups use `vault_search` instead. Args: question: The natural-language question to answer. Use `question`, not `query` or `prompt`.

• vault_commit

  Stage everything in the vault and create one commit. Companion to ``vault_write(commit=False)`` and ``vault_patch(commit=False)``: callers that opt out of per-write commits batch many writes and then flush with a single ``vault_commit`` call. Returns the new commit SHA on success, a clean-tree notice when there is nothing to commit, or a human-readable error. Args: message: Commit message. Empty defaults to "vault: batch update". This is the only parameter — there is no `project` argument; the commit spans the whole vault working tree.

• vault_delete

  Delete a single file from the vault (destructive; recoverable via git). Removes one file and, by default, commits the deletion so it stays recoverable from git history (``git revert`` / ``git show``). Files only — directories are rejected. A non-existent path is an error, unless ``idempotency_key`` is set (then a retry against an already-gone file is a no-op success). Args: project: Project slug or '_meta' for cross-project content. path: Relative path to the file within the project. commit: Must be True (the default). Unlike ``vault_write``, this tool has no deferred mod…

• vault_health

  Return vault health metrics, validation, and optional usage analytics. Always emits the ``## server`` identity block (version, python, vault path, backend presence, started_at) at the top. Without parameters, returns a health summary for all projects. When checks are specified, runs drift detection (frontmatter, stale, links). When include_usage is True, appends tool usage analytics. When include_runtime is True, appends runtime metadata (uptime, tools, budget). Args: project: Project slug to validate. Empty = all projects. checks: Validation checks to run. Empty = health summary on…

• vault_patch

  Surgical find-and-replace in a vault file with auto git commit. Supports single or multi-replacement. For a single replacement, provide ``find`` and ``replace``. For multiple replacements, provide ``patches`` — a list of ``{"find": "...", "replace": "..."}`` dicts applied in sequence. Do not mix both modes. Each ``find`` value must appear exactly once in the file (after prior patches in the list have been applied). If any patch fails validation, no changes are written. Uses 3-pass cascading match: exact → body-only → whitespace-normalized. Args: project: Project slug or '_meta' for cro…

• vault_write

  Write to the vault: append, replace a section, or create a new file. Modes: - append/replace: Update a project section. Requires section. - create: Create a new file with auto-generated frontmatter. Requires path; doc_type defaults to "note". Inferred automatically when you pass a path with no section, so operation may be omitted. Args: project: Project slug or '_meta' for cross-project content. content: Markdown content to write (body only for create mode). operation: 'append', 'replace', or 'create'. Default 'append'. 'create' is inferred when path is set and sectio…

• worker_status

  Show worker health: configuration, reachability, model, and usage. HIVE-384 reshaped this tool, and the reshape is the point rather than a side effect. The old output led with a dollar budget and reported two providers by *configuration*: it said "Ollama: offline / OpenRouter: no API key" for an unknown length of time while every caller treated the worker as a working capability. A status surface that cannot distinguish "configured" from "answers" is how a dead backend stays invisible. So reachability is **probed, not inferred**, and reported separately from configuration. The dollar figures…

• write

  Idempotent write: INSERT OR IGNORE on the idempotency key. One owning connection + lock makes the check-and-insert atomic; the UNIQUE column makes a retry a no-op even under concurrency.

Compare and alternatives

Featured in

• Best MCP servers for Obsidian

Signals

Stars

11

Forks

2

Open issues

53

Weekly downloads

2,341

Last commit

Oct 23, 2026 (5 days ago)

Last release

Oct 22, 2026 (6 days ago)

Last package publish

Oct 22, 2026 (6 days ago)

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

Details

Registry name

io.github.mlorentedev/hive-vault

Version

1.12.2

Auth

API key

Packages

pypi hive-vault

License

MIT

Repository

github.com/mlorentedev/hive

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql