Claude Self Reflect
Claude forgets everything. This fixes that. 🔗 www.npmjs.com/package/claude-self-reflect
What is Claude Self Reflect?
Claude Self Reflect is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to claude forgets everything. this fixes that. 🔗 www.npmjs.com/package/claude-self-reflect
Claude forgets everything. This fixes that. 🔗 www.npmjs.com/package/claude-self-reflect
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Claude forgets everything. This fixes that. 🔗 www.npmjs.com/
Use Cases
Maintainer
Works with
Installation
NPM
npx -y claude-self-reflectManual Installation
npx -y claude-self-reflectConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude Self Reflect
Claude Self-Reflect is a Rust-powered MCP server that gives Claude persistent cross-session memory by automatically indexing your local conversation history (stored as JSONL files in ~/.claude/projects/) into an embedded SQLite database with vector embeddings for semantic search. A single 44 MB binary with no external dependencies — no Docker, no cloud services, no Qdrant required — it exposes 12 MCP tools including semantic recall, file-based search, timeline analysis, and conversation retrieval, and optionally enriches memories with AI-generated narratives using the Anthropic API. Developers who use Claude Code daily and want it to remember past decisions, code patterns, and project context across sessions use Claude Self-Reflect to eliminate repetitive re-explanation.
Prerequisites
- Claude Code (conversations must be stored as JSONL in ~/.claude/projects/)
- Node.js 16+ and npm for the npx installation method
- Rust toolchain (only if building from source)
- Optional: An Anthropic API key (ANTHROPIC_API_KEY) if you want AI-generated memory narratives via the enrichment daemon
- macOS, Linux, or Windows with WSL2
Install via the automated script
The install script downloads the csr-engine binary, registers the MCP server with Claude Code, and installs the 6 session lifecycle hooks automatically.
curl -fsSL https://raw.githubusercontent.com/ramakay/claude-self-reflect/main/scripts/install.sh | shOr install via npm
Alternatively, install the npm package globally which provides the csr-engine command.
npm install -g claude-self-reflectOr build from source
Clone the repository, build the Rust binary with Cargo, copy it to your local bin directory, and run the initial setup.
git clone https://github.com/ramakay/claude-self-reflect.git
cd claude-self-reflect/csr-engine
cargo build --release
cp target/release/csr-engine ~/.local/bin/
csr-engine setupRestart Claude Code
After installation, restart Claude Code to activate the MCP server and all session hooks. The system will begin indexing your existing conversation history automatically.
Optionally enable AI narrative enrichment
For richer semantic summaries of past conversations, set your Anthropic API key and start the enrichment daemon in the background.
export ANTHROPIC_API_KEY=your_anthropic_api_key
csr-engine daemonCheck system health
Verify the memory engine is running and indexing correctly with the status command.
csr-engine statusClaude Self Reflect Examples
Client configuration
claude_desktop_config.json entry for Claude Self-Reflect using the npm package.
{
"mcpServers": {
"claude-self-reflect": {
"command": "npx",
"args": ["-y", "claude-self-reflect"]
}
}
}Prompts to try
Example prompts that leverage Claude Self-Reflect's 12 MCP memory tools in Claude Code.
- "What have we discussed about the authentication module in past sessions?"
- "Search my conversation history for anything related to database migrations."
- "Show me a timeline of when we worked on the payments feature."
- "What decisions did we make about the API structure last month?"
- "Find conversations where we debugged the React rendering issue."
- "Summarise everything I know about this project from past sessions."Troubleshooting Claude Self Reflect
No memories are returned even though conversations exist in ~/.claude/projects/
Run 'csr-engine status' to check if the indexer has processed the JSONL files. If the index is empty, run 'csr-engine setup' again to trigger initial indexing. Ensure the conversation files are valid JSONL format.
The MCP server tools are not visible in Claude Code after installation
Restart Claude Code completely after running the install script. The session hooks and MCP registration only take effect on the next launch. Check ~/.claude/settings.json to confirm the server was registered.
AI narrative enrichment daemon exits immediately
Ensure ANTHROPIC_API_KEY is set and valid before starting 'csr-engine daemon'. The daemon is optional — the core semantic search works without it using local embeddings only.
Frequently Asked Questions about Claude Self Reflect
What is Claude Self Reflect?
Claude Self Reflect is a Model Context Protocol (MCP) server that claude forgets everything. this fixes that. 🔗 www.npmjs.com/package/claude-self-reflect It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude Self Reflect?
Install via npm with the command: npx -y claude-self-reflect. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Claude Self Reflect?
Claude Self Reflect works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude Self Reflect free to use?
Yes, Claude Self Reflect is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Claude Self Reflect Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Claude Self Reflect? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Claude Self Reflect in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Claude Self Reflect?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.