remem-mcp — Claude Code MCP server: memory and code graph
A local MCP server that stores agent memory, maps code relationships, and keeps a Wiki in one SQLite file. Useful when context must survive sessions.
claude mcp add remem-mcp -- npx -y remem-mcpWhat remem-mcp — Local-first MCP Memory + CodeGraph + Wiki does
remem-mcp gives an AI coding agent local memory, CodeGraph, and Wiki tools through MCP. It records errors, decisions, and facts, then brings relevant context back before a response. Memory is also restored after context compaction. No API key, cloud service, or separate database server is needed; the data stays in SQLite.
Hooks cover session start, prompt submission, tool use, compaction, and session end. CodeGraph uses tree-sitter to index symbols, calls, and imports across 9 languages. The agent can search code, inspect callers, and estimate an impact area. A restart is required after setup, so the initial memory check will not work before reopening the agent.
For team sharing, export memory to .remem-mcp/memory-export.jsonl and commit the file to git. Optional settings live in ~/.config/remem-mcp/config.json; REMEM_DB_PATH changes the database location. Cross-project reads use REMEM_GLOBAL_SESSION_KEY, while ordinary captures remain project-local.
What it helps with
- carry errors and decisions across sessions
- restore context after compaction
- map symbols and code relationships
- trace callers and estimate change impact
- share project memory through git
Example prompts for the agent
- Remember the decision we made about this error and use it in later sessions.
- Index the code under
src, then find who callsparseTar. - What do you remember about earlier errors in this project?
How to install remem-mcp — Local-first MCP Memory + CodeGraph + Wiki
Platform CLI
claude mcp add remem-mcp -- npx -y remem-mcpPlatform CLI
codex mcp add remem-mcp-local-first-mcp-memory-codegraph-wiki -- npx -y remem-mcpConfig file
{
"mcpServers": {
"remem-mcp-local-first-mcp-memory-codegraph-wiki": {
"command": "npx",
"args": [
"-y",
"remem-mcp"
]
}
}
}Config file
{
"servers": {
"remem-mcp-local-first-mcp-memory-codegraph-wiki": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"remem-mcp"
]
}
}
}Platform CLI
gemini mcp add remem-mcp-local-first-mcp-memory-codegraph-wiki npx -y remem-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about remem-mcp — Local-first MCP Memory + CodeGraph + Wiki
How do I install remem-mcp in Claude Code?
Run claude mcp add remem-mcp -- npx -y remem-mcp. Then restart the agent.
What does remem-mcp do?
It stores coding context locally, retrieves relevant memories, and exposes CodeGraph features for symbols, calls, and imports.
Does remem-mcp require an API key or cloud database?
No. It uses a local SQLite file and does not require an API key, cloud service, or separate database server.
