Persistent semantic memory for AI agents
@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
Tools (5)
rememberStore a memory with automatic embeddingrecallSemantic search across stored memorieshistoryRecent conversation historyforgetDelete one memory, a session, or entries before a datestatsMemory statistics for a sessionEnvironment Variables
ENGRAM_DBSQLite database pathENGRAM_EMBEDDING_URLOllama base URL for embeddingsConfiguration
{"mcpServers": {"engram": {"command": "npx", "args": ["-y", "@cartisien/engram-mcp"], "env": {"ENGRAM_DB": "~/.engram/memory.db"}}}}