Memshelf MCP

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

Tools

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

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Python package

Tools (15)

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

• memshelf_advise

  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_importImport an exported transcript for shelving

  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_initBootstrap a memory shelf

  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_purgeDelete episodes past their retain_untilcan change or delete data

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

• memshelf_rebuildRegenerate the shelf's derived files from its episodes

  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_resolveResolve multi-writer shelf conflicts

  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_rollupCollapse a period into one digest-of-digests

  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_shelveShelve an episode to the memory shelf

  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.

• memshelf_syncFast-forward the shelf clone to its remote

  Fetch and fast-forward the shelf clone to its remote, writing nothing else — for a clone behind the bot's render or another session's shelve. Refuses on a dirty tree or a diverged branch, with the fix.

Signals

Stars

0

Forks

0

Open issues

10

Weekly downloads

53

Last commit

Oct 13, 2026 (18 days ago)

Last release

Oct 7, 2026 (24 days ago)

Last package publish

Oct 7, 2026 (24 days ago)

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

Details

Registry name

io.github.ignatenkofi/memshelf-mcp

Version

0.4.0

Auth

No auth

Packages

pypi memshelf-mcp

License

MIT

Repository

github.com/ignatenkofi/memshelf-mcp

Website

ignatenkofi.github.io/memshelf-mcp/

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql