Memshelf MCP server

Read from the package source without running it. The installed server may list more.

• memshelf_advisewrite action

  Report what your context window is made of and what you could put down — breakdown plus ranked proposals; writes nothing. Pass your window's occupants (label, size, live or not); with none it reports the shelf alone.

• memshelf_doctor

  Diagnose shelf integrity: episode schema, digest contract at rest, leaked secrets, ledger consistency, INDEX budget. Read-only; fixes nothing. `check_remote` adds the network probe for a public remote.

• memshelf_import

  Retro-shelve an exported dialog without pulling it through context: `discover` lists conversations by content markers, `extract` writes one cleaned conversation to a working file for segmenting and shelving.

• memshelf_index

  Return the shelf INDEX — the small recall entry point. Read it before answering anything about past work, then recall only what you need.

• memshelf_initwrite action

  Create (or top up) a memory shelf: layout, categories, INDEX preamble, POLICY.md, shelf.yml. Idempotent; never overwrites existing files.

• memshelf_lint_digest

  Check a digest against the contract while it is still being written — the same validator `memshelf_shelve` runs, writing nothing. `strict` turns warnings into failures.

• memshelf_purgewrite action

  Drop episodes past `retain_until`, then reindex. Dry run unless `apply=true`; removes working-tree files only, git history keeps them.

• memshelf_rebuild

  Regenerate the derived files (ledger.tsv, .meta.json, INDEX.md, stats.svg) from the episodes; `check=true` only reports drift. Hand-run it only on a shelf whose bot is not rendering.

• memshelf_recall

  Fetch a shelved episode by id, or one `## Section` of it, as a data envelope. Prefer the section when it answers the question.

• memshelf_resolvewrite action

  Settle the two-writers-on-parallel-branches conflict: union derived rows, rebuild INDEX, run doctor. Episode conflicts are reported, never auto-merged; safe outside a conflict too.

• memshelf_rollupwrite action

  Archive a period's episodes behind one digest-of-digests you write, shrinking INDEX; nothing is deleted. Not the answer to `index-bloat`.

• memshelf_search

  Grep the shelf for episodes matching every query token; returns addresses and snippets. Use when the episode id is unknown.

• memshelf_shelve

  Offload one closed topic to the shelf as a durable, indexed episode — redaction, digest contract and git commit included. Derived files are not written here — they are rendered by `memshelf_rebuild` or the shelf's bot. Details: docs/tools.md.

• memshelf_stats

  Report the shelf's token economy: standing cost vs shelved mass, claimed compression, realized savings from logged recalls.

• Code scan30 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 5 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Memshelf: common questions

Is Memshelf MCP server safe?

Yes, by our scan: it is graded A (92/100). Read the Memshelf safety report

How do I install Memshelf?

It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.

Does Memshelf need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Memshelf maintained?

The last commit was 5 days ago (2026-09-14). The latest release is v0.3.0.

What can I use instead of Memshelf?

Servers from other publishers that do the same job: Nexusmem MCP server, memgit MCP server and Bettermemory MCP server. Compare all Memshelf alternatives.