Memory status
Report the Neo4j memory backend's connection mode (local Docker vs remote), active project scope, and entity/observation counts, or list every project registered in the database with its usage. Use when the user asks whether memory is working, which database it's using, how much has been remembered, what projects are stored in the graph, or how much space/usage each project takes.From its SKILL.md
npx -y skills add troglodyte/claude-neo4j-mem --skill memory-statusAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.5 KB, as published. Nobody here has run it
Two questions land here. Pick the tool that matches which one was asked.
"Is memory working / how much is stored for this project?"
Call the memory_status MCP tool and present the result: connection URI, whether it's running in local or remote mode, the active project scope, and the entity/observation counts.
"What projects are in the database / how much is in each?"
Call the memory_list_projects MCP tool. It returns every project in the graph with its entity count, observation count, and last-activity timestamp — across all projects, not just the current one. Present it as a table sorted by last activity.
For a deeper report, run scripts/memory-usage.sh from the plugin directory. On top of the same table it adds each project's first-seen date, observations in the last 7 days, database totals, and hygiene warnings: projects recorded under two different names (which silently splits one repo's memory in half), entities hoarding 100+ observations, and empty entity stubs. Use --quiet for just the table.
Do not write ad-hoc Cypher for these questions when the tools above answer them.
"This project's subsystem tags are a mess / everything is untagged"
The SessionStart map and npm run usage both surface fragmentation — a junk-drawer
tag holding most of the graph, three-observation slivers that should be merged, or a
large (untagged) bucket. Every read tool returns each observation's subsystem, and
memory_search / memory_recent / memory_timeline accept subsystem: "(untagged)"
to enumerate the unclassified ones, so the diagnosis can be made in-session.
Acting on it is a maintenance script, not an MCP tool, because reclassification is an
LLM pass over every affected observation: npm run backfill-subsystems tags whatever
is currently untagged, and --retag TAG reclassifies observations already carrying a
tag (--retag general is how a junk drawer gets emptied). Both take --dry-run to
show the proposed tags without writing, and --project NAME to scope to one project.
Retagging edits observations in place — ids, timestamps and session links are
preserved — so it is safe to re-run and safe to interrupt.
Running arbitrary Cypher
If the user genuinely needs a query the tools do not cover, use scripts/cypher.sh "<query>". It resolves credentials automatically and, in local mode, borrows the cypher-shell binary from inside the Neo4j container — so nothing needs to be installed. It only asks the user to install cypher-shell when connecting to a remote database from a host that lacks it, and even then the memory_* tools and npm run memory -- <cmd> keep working without it. Never tell the user they must install cypher-shell before checking that fallback.
When things fail
If a tool call fails, explain that the Neo4j memory backend is unreachable and point to the plugin's setup: run npm run configure inside the plugin directory, and for local mode make sure the container is running (scripts/setup-local.sh starts it, under Podman or Docker). scripts/check-health.sh diagnoses the whole stack and prints PASS/FAIL per check.