@cartisien/engram-mcp

Persistent semantic memory for AI agents — MCP server powered by @cartisien/engram

Give any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf) persistent memory that survives across sessions.

npx -y @cartisien/engram-mcp

---

What it does

Exposes 5 tools to any MCP client:

Tool	Description
remember	Store a memory with automatic embedding
recall	Semantic search across stored memories
history	Recent conversation history
forget	Delete one memory, a session, or entries before a date
stats	Memory statistics for a session

Memories are stored in SQLite. Semantic search uses local Ollama embeddings (nomic-embed-text) — no API key, no cloud. Falls back to keyword search if Ollama isn't available.

---

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "@cartisien/engram-mcp"],
      "env": {
        "ENGRAM_DB": "~/.engram/memory.db"
      }
    }
  }
}

Restart Claude Desktop. You'll see remember, recall, history, forget, and stats available as tools.

Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "@cartisien/engram-mcp"]
    }
  }
}

---

Configuration

Env Var	Default	Description
ENGRAM_DB	~/.engram/memory.db	SQLite database path
ENGRAM_EMBEDDING_URL	http://localhost:11434	Ollama base URL for embeddings

Local Embeddings (Recommended)

Install Ollama and pull the embedding model:

ollama pull nomic-embed-text

Semantic search activates automatically. Without Ollama, keyword search is used.

---

Example Usage

Once connected, your agent can:

remember(sessionId="myagent", content="User prefers TypeScript over JavaScript", role="user")

recall(sessionId="myagent", query="what are the user's coding preferences?", limit=5)
# Returns: [{ content: "User prefers TypeScript...", similarity: 0.82 }, ...]

history(sessionId="myagent", limit=10)

stats(sessionId="myagent")
# { total: 42, byRole: { user: 20, assistant: 22 }, withEmbeddings: 42 }

---

Part of the Cartisien Memory Suite

• @cartisien/engram — core memory SDK
• @cartisien/engram-mcp — this package, MCP server
• @cartisien/extensa — vector infrastructure (coming soon)
• @cartisien/cogito — agent identity & lifecycle (coming soon)

---

MIT © Cartisien Interactive