# engram

Stores project knowledge locally and helps an agent retrieve it by meaning. Useful when context needs to carry across sessions and projects.

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

## What it does

engram saves memories in SQLite, links them into a knowledge graph, and retrieves relevant details through semantic search. An agent can ask about stored information, request a session briefing, or surface memories related to its current context. Import tools are available for Obsidian vaults and Claude Code memory.

An LLM helps extract and combine stored information, including spotting contradictions. Processing through Gemini requires your own `GEMINI_API_KEY`; the key is used for embeddings and memory handling. The data stays local, but Gemini-backed processing depends on that key.

To connect it to Claude Code, use `claude mcp add`. The setup below runs `npx -y engram-sdk`; another supported configuration appears in the FAQ.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GEMINI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add engram -e GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y engram-sdk
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tstockham96-engram --env GEMINI_API_KEY=<GEMINI_API_KEY> -- npx -y engram-sdk
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tstockham96-engram": {
            "command": "npx",
            "args": [
                "-y",
                "engram-sdk"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tstockham96-engram": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "engram-sdk"
            ],
            "env": {
                "GEMINI_API_KEY": "<GEMINI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> tstockham96-engram npx -y engram-sdk
```
Replace <…> with your own values

## When to use it
- carry project context between sessions
- retrieve related details by meaning instead of text matching
- prepare a briefing before an agent session
- import memories from Obsidian or Claude Code
- find contradictions in stored knowledge

## Example prompts
- Save that this project requires SQLite compatibility and local data storage.
- Before the session, summarize recent decisions and unfinished tasks.
- Import my Obsidian notes into the agent's memory.

## 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
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

## Other versions with the same name
- [engram · nickcirv](https://affpapa.org/en/nevibecode/mcp/nickcirv-engram.md) — ★ 143
- [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 · rwnalds](https://affpapa.org/en/nevibecode/mcp/rwnalds-engram.md) — ★ 17
- [engram · girishbuilds](https://affpapa.org/en/nevibecode/mcp/girishbuilds-engram.md) — ★ 7

---
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