Engram
A self-hosted MCP server that gives AI agents shared, long-term memory over a git-backed folder of markdown, enabling persistent knowledge search, read, and write without a database.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
rwnalds
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
brain_schemaREAD THIS FIRST, before searching or writing. Returns the vault's SCHEMA.md (folder taxonomy, frontmatter conventions, wikilink model, write protocol) AND a live description of this specific vault: its folders, the `status:` values actually in use, how search ranks notes by authority, and any integr…
brain_searchbrain_readbrain_listList every note with metadata (path, title, folder, type, tags, status, authority). Use to discover what exists. `authority` tells you which notes are source-of-truth and which are history.
brain_recentNotes changed most recently, newest first. Use to catch up on what humans or other agents have done since you last looked.
brain_treeReturn the folder/file tree of the vault.
brain_backlinksNotes that link to the given note.
brain_graphThe knowledge graph (nodes + edges from wikilinks and related:). Optional folder filter.
brain_writebrain_editOverwrite a note. Pass `content` (full raw markdown incl. frontmatter) — read first with brain_read, then write the whole file back. Also accepts `body` (+ optional `frontmatter`) like brain_write.
brain_appendAppend text to a note (creates it if missing).
brain_moveMove or rename a note. This is how you retire something: when a note stops being true, move it to an archive folder (see brain_schema → conventions.ranking.archiveFolders) rather than deleting it. Archived notes are demoted in search and excluded by default, so they stop misleading agents while the …
brain_create_folderCreate a new folder in the vault (with a .gitkeep).
brain_supersedebrain_captureHand over a ROUGH note / brain-dump and let the vault file it. An agent loop reads SCHEMA.md, searches for what already exists, then deliberately creates a new note, appends to a matching one, or archives what this supersedes — and returns a manifest of every path it touched. It reads a note before …
brain_deleteDelete a note (recoverable via git history). Prefer brain_move into an archive folder — deleting destroys the reasoning trail, archiving only removes it from search. Delete when the note is wrong or duplicated, archive when it is merely no longer true.
Disclosed vulnerabilities in this server's declared npm dependencies (via OSV). Whether each is reachable depends on the installed versions.
simple-git has blockUnsafeOperationsPlugin bypass via case-insensitive protocol.allow config key enables RCE
@modelcontextprotocol/sdk has cross-client data leak via shared server/transport instance reuse
Anthropic's MCP TypeScript SDK has a ReDoS vulnerability
Model Context Protocol (MCP) TypeScript SDK does not enable DNS rebinding protection by default
Next.js: Middleware / Proxy bypass in App Router applications using Turbopack and single locale
ALLOWED_EMAILSALLOWED_GITHUB_LOGINSANTHROPIC_API_KEYAPP_URLARCHIVE_FOLDERSAUTH_DISABLEDAUTH_SECRETCAPTURE_MODELENGRAM_DATA_DIR1. Deploy this repo (root Dockerfile), mount a volume at /data, set =/data.ENGRAM_GIT_BOOT_DELAY_MSENGRAM_STATE_DIRGITHUB_CLIENT_IDGITHUB_CLIENT_SECRETGIT_AUTHOR_EMAILGIT_AUTHOR_NAMEGIT_SYNC_ENABLEDGOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETHARNESS_ENABLEDMCP_TOKENVAULT_DIR/path/to/your/obsidian-or-markdown/vault bun devVAULT_IGNORENEXT_PUBLIC_APP_NAMETool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
32/32 tools missing one or more hints — brain_schema (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); brain_search (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); brain_read (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +29 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Tool test coverage
14/32 tools referenced in tests (44%)
Write tests that reference each tool by name so every tool has at least one test.
Production dependencies are patched
1 critical, 9 high severity in production deps — simple-git@3.27.0 (critical), @modelcontextprotocol/sdk@1.13.0 (high)
Run npm audit fix, or upgrade the affected packages to a non-vulnerable version.
Dependency freshness
4/29 production deps abandoned (no release in 2+ years): d3-force@2022-06-14 (4.2y), gray-matter@2023-07-12 (3.1y), rehype-raw@2023-11-20 (2.7y)
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/rwnalds/engram)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check