RemembrallMCP — Claude Code MCP server: what it does, how to install
Maintains cross-session memory and maps code dependencies down to struct fields in PostgreSQL with pgvector. Cuts repetitive agent exploration on large codebases.
claude mcp add remembrallmcp -e DATABASE_URL=<DATABASE_URL> -- npx -y remembrallmcpWhat RemembrallMCP does
RemembrallMCP runs on Rust and builds a dependency map across nine languages using tree-sitter. It indexes methods alongside individual struct fields. When checking what a refactor might break, the agent queries remembrall_impact instead of scanning dozens of files. The lookup takes under ten milliseconds.
Persistent memory preserves decisions between agent sessions. Architecture choices and notes live in PostgreSQL. The agent retrieves them with hybrid semantic and full-text search, keeping context across reboots.
Running the server without Docker or a configured PostgreSQL 16 instance with pgvector will fail immediately. Connecting an MCP client requires passing the DATABASE_URL environment variable, while GitHub ingestion requires the authenticated gh CLI.
What it helps with
- trace upstream references down to specific struct fields
- retain architectural decisions across agent sessions
- inspect change impact without reading dozens of files
- retrieve past project context via hybrid search
Example prompts for the agent
- Run
remembrall_impactto list callers ofAuthMiddleware - Search past token discussions using
remembrall_recall - Index the current project directory with
remembrall_index
How to install RemembrallMCP
Platform CLI
claude mcp add remembrallmcp -e DATABASE_URL=<DATABASE_URL> -- npx -y remembrallmcpReplace <…> with your own values
Platform CLI
codex mcp add remembrallmcp --env DATABASE_URL=<DATABASE_URL> -- npx -y remembrallmcpReplace <…> with your own values
Config file
{
"mcpServers": {
"remembrallmcp": {
"command": "npx",
"args": [
"-y",
"remembrallmcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"remembrallmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"remembrallmcp"
],
"env": {
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DATABASE_URL=<DATABASE_URL> remembrallmcp npx -y remembrallmcpReplace <…> with your own values
Step 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 RemembrallMCP
How do I install RemembrallMCP in Claude Code?
Start the database with docker compose up -d, then run claude mcp add remembrallmcp -e DATABASE_URL=<DATABASE_URL> -- npx -y remembrallmcp.
What does RemembrallMCP do?
It parses codebases via tree-sitter and stores the symbol graph in PostgreSQL with pgvector. Coding agents use it to look up callers and recall previous decisions instantly.
What dependencies does RemembrallMCP require?
The server requires Docker or a local PostgreSQL 16 installation with the pgvector extension. Ingesting GitHub repositories also requires an authenticated gh CLI.
