ClaudeX
Persistent memory + FTS5 full-text search for Claude Code conversation history. Indexes ~/.claude/projects/ JSONL into SQLite, exposes 10 MCP tools (store/recall/search memories, browse sessions, get summaries) plus prompts. Includes a web UI for vis
What is ClaudeX?
ClaudeX is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to persistent memory + fts5 full-text search for claude code conversation history. indexes ~/.claude/projects/ jsonl into sqlite, exposes 10 mcp tools (store/recall/search memories, browse sessions, get ...
Persistent memory + FTS5 full-text search for Claude Code conversation history. Indexes ~/.claude/projects/ JSONL into SQLite, exposes 10 MCP tools (store/recall/search memories, browse sessions, get summaries) plus prompts. Includes a web UI for vis
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Persistent memory + FTS5 full-text search for Claude Code co
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @kunwarshah/claudexManual Installation
npx -y @kunwarshah/claudexConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use ClaudeX
ClaudeX is a persistent memory and full-text search system for Claude Code that indexes your conversation history from ~/.claude/projects/ JSONL files into a local SQLite database using FTS5, and exposes 10 MCP tools and 3 prompts for storing memories, searching sessions, and recalling context. It also includes a React web UI (served on port 3400) for visually browsing and searching all your Claude Code conversations with session analytics, theme support, and export capabilities. Developers who run many Claude Code sessions across different projects use ClaudeX to maintain context between conversations without re-explaining background information.
Prerequisites
- Node.js 18 or later and npm
- Claude Code CLI installed and actively used (conversation history must exist at ~/.claude/projects/)
- The @kunwarshah/claudex npm package
- An MCP client — ClaudeX works as an MCP server for Claude Code itself
Install ClaudeX globally
Install the package globally from npm so both the claudex web server and claudex-mcp binary are available in your PATH.
npm install -g @kunwarshah/claudexStart the ClaudeX server
Run claudex to start the backend API (port 3400) and frontend (port 3000). It will automatically index your Claude Code conversation history from ~/.claude/projects/.
claudex
# Custom port: claudex --port 3500
# Custom project root: claudex --project-root ~/my-claude-projectsAdd the MCP server to Claude Code
Register the claudex-mcp binary as an MCP server in Claude Code using the stdio transport. This gives Claude access to the 10 memory and session tools.
claude mcp add --transport stdio claudex -- claudex-mcpVerify the MCP tools are available
In Claude Code, ask Claude to list the available MCP tools. You should see tools including memory-create, memory-search, search-sessions, get-conversation, and others from ClaudeX.
Browse the web UI
Open the ClaudeX web interface in your browser to visually explore your conversation history, search sessions, and view analytics.
open http://localhost:3000ClaudeX Examples
Client configuration
Claude Desktop configuration for the ClaudeX MCP server using the globally installed claudex-mcp binary.
{
"mcpServers": {
"claudex": {
"command": "claudex-mcp",
"args": [],
"env": {
"PROJECT_ROOT": "/Users/you/.claude/projects",
"PORT": "3400"
}
}
}
}Prompts to try
Example prompts to use with Claude Code once ClaudeX is connected as an MCP server.
- "Search my conversation history for sessions where I worked on authentication middleware"
- "Store a memory: the production database uses read replicas for all SELECT queries"
- "Recall all memories in the 'architecture' category"
- "Get the full conversation from my last session on the billing-service project"
- "Summarize my recent Claude Code activity from the past week"Troubleshooting ClaudeX
claudex-mcp command not found after global install
Run npm list -g @kunwarshah/claudex to confirm the install succeeded. If your global npm bin directory is not in PATH, add it: export PATH=$(npm bin -g):$PATH
No conversation history appears in the web UI or search
Verify that ~/.claude/projects/ exists and contains JSONL files. If your Claude Code projects are stored elsewhere, start ClaudeX with --project-root /path/to/your/projects.
Port 3400 is already in use
Start ClaudeX with a different port: claudex --port 3500. Update the PORT env var in your MCP config to match the port you chose.
Frequently Asked Questions about ClaudeX
What is ClaudeX?
ClaudeX is a Model Context Protocol (MCP) server that persistent memory + fts5 full-text search for claude code conversation history. indexes ~/.claude/projects/ jsonl into sqlite, exposes 10 mcp tools (store/recall/search memories, browse sessions, get summaries) plus prompts. includes a web ui for vis It connects AI assistants to external tools and data sources through a standardized interface.
How do I install ClaudeX?
Install via npm with the command: npx -y @kunwarshah/claudex. 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 ClaudeX?
ClaudeX works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is ClaudeX free to use?
Yes, ClaudeX is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
ClaudeX Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to ClaudeX? 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 ClaudeX 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 ClaudeX?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.