GoodMemory MCP server
io.github.hjqcan/goodmemory·v0.7.5·20 starsDurable user/project memory for MCP clients: recall context and remember selected facts.
20 stars232 downloads/wk
Reviews
Write oneNobody has reviewed GoodMemory yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
GoodMemory tools (10)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
goodmemory_get_contextFetch a compact memory context fragment for a specific question about this workspace. Call it when hook-injected context is missing or insufficient, or when you need memory for a different question than the current prompt.
goodmemory_get_recordsAdvanced recall. Use this for progressive GoodMemory recall after search_index or timeline returns recordRefs that need detail.
goodmemory_inspect_memoryDiagnostic (beyond the primary goodmemory_get_context / goodmemory_remember tools). Use this when you need a read-only snapshot of durable and runtime GoodMemory state for the current workspace.
goodmemory_read_artifactsDiagnostic. Use this when you need the accepted host-adapter artifact projection for the current workspace.
goodmemory_rememberUse this to persist a memory-worthy statement as durable GoodMemory. The write is governed: classification and dedupe may reject or merge it (see accepted/rejected and per-event outcomes in the result). If accepted is 0, the explanation field says why. Accepted installed-mode writes are also recorded in the writeback audit ledger; the result's auditEventId works with `goodmemory <host> writeback i
goodmemory_search_indexAdvanced recall (past goodmemory_get_context). Progressive GoodMemory recall step 1: fetch a compact recordRef index for a query, then call goodmemory_get_records for detail. Prefer this over goodmemory_get_context when you need specific records rather than a rendered summary.
goodmemory_statsDiagnostic. Record counts and runtime metadata (embedding/retrieval status via the `retrieval` field) for the current GoodMemory scope. Call it to check whether memory exists here before assuming an empty store.
goodmemory_timelineAdvanced recall. Use this for progressive GoodMemory recall when you need compact chronological context before drilling into recordRefs.
goodmemory_trace_recallDiagnostic. Explain a recall: routing, hits, per-candidate scores, and suppression reasons. Call it when a memory that should exist did not surface, or when a surfaced memory looks wrong.
jsonRespond with a JSON object.
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- Code scan234 source files scanned20/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 12 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- mediumeval / new Function used
exec.evaldist/chunk-3jepk63r.js: …ludes("Cloudflare"))return!1;try{return new Function(""),!0}catch($){return!1}});function f4(…
How GoodMemory compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,255 servers
- Tools
- 10
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 20
- more than 91% of 28,688 servers
- Downloads a week
- 232
- more than 77% of 12,191 servers with a package
What its tools let an agent do: 10 read
Install GoodMemory in Claude Code, Cursor or VS Code
Runs npx -y goodmemory on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add goodmemory -- npx -y goodmemory
What the publisher says
From the GoodMemory repository's README, as published. We do not edit it. Read it on GitHub
GoodMemory
Language: English | 简体中文
GoodMemory is a memory layer for AI products and coding agents.
Release source: this source targets the 0.8.0 stable release.
Registry commands require goodmemory@0.8.0 to be published. The release
workflow verifies npm latest and the already published GitHub assets
against the locally prepared manifest; it does not rebuild or publish.
It gives chat apps, copilots, and agent hosts a durable user/project memory loop: write selected facts, retrieve the right context, inject it into the next turn, audit what happened, and delete it when it is wrong.
GoodMemory is not an LLM, agent framework, vector database, or generic RAG system. It is the product memory layer between your app or installed agent host and the model runtime.
What You Get
exportMemory, importMemory, and deleteAllMemory.
- Durable memory API: remember, recall, buildContext, feedback, forget,
managed hooks, installed Codex pre-action, goodmemory status, read-only MCP, and opt-in writeback.
- Installed agent memory for Codex and Claude Code through goodmemory setup,
RememberProfile, rememberRules, RememberInput.annotations, and named extractor ids.
- Public write customization with GoodMemoryConfig.remember,
and goodmemory/http through compiled dist artifacts and TypeScript declarations.
- Package exports for goodmemory, goodmemory/ai-sdk, goodmemory/host,
injected adapters, and embedding providers can be added when needed.
- Local-first storage: Bun gets durable SQLite by default; explicit Postgres,
provider-backed evals, package smoke tests, and quality gates.
- Evaluation and release evidence paths for deterministic tests, live evals,
OpenAI Build Week 2026
Pre-existing foundation. GoodMemory existed before OpenAI Build Week. The pre-event foundation already included the core memory API, local SQLite/Postgres storage, installed-host integration, and the local Inspector. The hackathon entry is the work added after the submission period opened on July 13, 2026, not the entire repository.
Added during Build Week. Dated commits completed and published v0.6.0, strengthened generalized retrieval and iterative-recall verification, added claim-source provenance coverage, hardened installed-host canaries and leakage audits, and expanded the controlled Codex coding-effect evaluation path. Review the pre-event-to-Build-Week diff and its dated commit history for the exact boundary.
How Codex and GPT-5.6 were used. Codex with GPT-5.6 was the primary implementation and verification environment: exploring the repository, implementing and reviewing changes, writing regression tests, reproducing installed-host behavior, and exercising the release and coding-effect evidence paths. GPT-5.6 also powers disclosed non-judge model calls in current evaluation profiles; public-claim paths either use deterministic scoring or keep the judge independent from the answer model.
Run and verify. After publication, install 0.8.0 from the registry and inspect its local memory surface:
npm install -g goodmemory@0.8.0
goodmemory setup --host codex
goodmemory status codex --workspace-root .
goodmemory inspector serveVerify the repository from source with bun install --frozen-lockfile, bun test, and bun run typecheck. See the Devpost submission and public demo video.
Claim boundary: the submission demonstrates durable cross-session memory, governed writeback, recall evidence, and inspection/deletion infrastructure. It does not claim that GoodMemory has already proven an improvement in Codex coding outcomes; that paired hidden-test evaluation remains an active, fail-closed evidence track.
Start Here: Codex Or Claude Code
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
GoodMemory: common questions
- Is GoodMemory MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the GoodMemory safety report
- How do I install GoodMemory?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does GoodMemory need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is GoodMemory maintained?
- The last commit was 15 days ago (2026-10-20). The latest release is v0.7.5.
- What can I use instead of GoodMemory?
- Servers from other publishers that do the same job: Memorix MCP server and Knowl MCP server.
- How does GoodMemory compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,255 servers); tools 10 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to GoodMemory
Same job from other publishers: the closest match first, then the best rated.