# Engram

Engram gives agents a shared Markdown vault backed by Git and filters out notes marked as outdated. It suits projects where multiple agents need to read and update the same knowledge base.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: rwnalds
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rwnalds/engram
- Updated: 2026-08-14
- HTML: https://affpapa.org/en/nevibecode/mcp/rwnalds-engram

## What it does

Engram connects MCP clients to a shared folder of Markdown notes. Agents can read and write in the same vault, while Git keeps the files and records changes. Search checks whether a note is still valid: entries marked as superseded or past their validity date are withheld, with the reason sent to the agent.

The package includes a dashboard for searching notes, inspecting file diffs, and curating the vault. An in-memory index supports full-text search and links between notes; the files remain the source of truth. Per-agent tokens can limit access to reading or writing. Docker is needed for the provided Claude Code launch command.

Engram works with Obsidian vaults and MCP clients including Claude Code, Codex, and Cursor. To add it to Claude Code, run `claude mcp add rwnalds-engram -- docker run -i --rm ghcr.io/walds/engram:0.1.2`?

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add rwnalds-engram -- docker run -i --rm ghcr.io/rwnalds/engram:0.1.2
```

### Codex

**Platform CLI**
```bash
codex mcp add rwnalds-engram -- docker run -i --rm ghcr.io/rwnalds/engram:0.1.2
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "rwnalds-engram": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/rwnalds/engram:0.1.2"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "rwnalds-engram": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/rwnalds/engram:0.1.2"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add rwnalds-engram docker run -i --rm ghcr.io/rwnalds/engram:0.1.2
```

## When to use it
- share project notes across agents
- keep retired facts out of search results
- inspect who changed a note and review its diff
- search Markdown notes and their linked pages

## Example prompts
- Save the new API endpoint in the shared project memory.
- Find the current project price and show any notes left out of the results.
- Check who last edited the setup notes.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [engram · nickcirv](https://affpapa.org/en/nevibecode/mcp/nickcirv-engram.md) — ★ 143
- [engram · tstockham96](https://affpapa.org/en/nevibecode/mcp/tstockham96-engram.md) — ★ 47
- [engram · kael-bit](https://affpapa.org/en/nevibecode/mcp/kael-bit-engram.md) — ★ 28
- [Engram · get-engram](https://affpapa.org/en/nevibecode/mcp/engram.md) — ★ 19
- [engram · hbarefoot](https://affpapa.org/en/nevibecode/mcp/hbarefoot-engram.md) — ★ 9

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md